mm 



4 



Xerox Control Program for Real-Time (CP-R) 

Xerox 550 and Sigma 9 Computers 



Real-Time and Batch Processing 
Reference Manual 



90 30 85D 
April 1976 



Filt No.: 1X13 
A Xaroa Corporation. 1974 I97t> Punted in u S A 



REVISION 



This publication it a revision of the Xerox Control Program lor teal-Time (CP-t)/^T,SP Reference Manual, 
Publication Number 90 30 85C (dated Jovember 1974). This revision incorporate* changrs that reflect version DO0 
of the CP-R system. 



RELATED PUBLICATIONS 

Title 

Xerox 550 Computer Reference Manual 

Xerox Sigma 9 Computer Reference Manual 

Xerox Control Program for Real-Time (CP-R)/OPS Reference Manual 

Xerox Control Program for Real-Time (CP-R)/System Technical Manual 

Xerox Control Program for Real-Time (CP-R)/RT,BP User's Guide 

Xerox Chorocter-Oriented Communications Equipment/Reference Manual 
(Models 7611-7616/7620-7623) 

Xerox Mathematical Routines/Technical Manual 

Xerox Assembly Program (AP)/LN,OPS Reference Manual 

Xerox SL-1/Reference Manual 

Xerox Extended FORTRAN IV/LN Reference Monuof 

Xerox Extended FORTRAN IV/OPS Reference Monuol 

Xerox Extended FORTRAN/Librory Technical Manual 

Xerox Availability Features (CP-R) Reference Manual 

Monuol Content Codes: BP - batch processing, LN - languoge, OPS - operations, RP - remote processing, 
RT - real-time, SM - system management, TS - time-sharing, UT - utilities. 



Publication No. 


90 30 77 


90 17 33 


* 

90 30 86 


90 30 88 


90 30 87 


90 0981 


90 09 06 


90 30 00 


90 16 76 


90 09 56 


90 1143 


90 15 24 


90 31 10 



) 

Ihe specifications of rhe software system described in hSii publication o<e wbject to change without notice . The amiability or pei fu nnun c e of tomo features k 

may depend on a specific conligurof.e-. ef equipment such as additional tape units or larger im nofy, Customers should canwlt their Xero* soles representative ' 

for details. 

11 



CONTENTS 



PREFACE 

COMMAND SYNTAX NOTATION 

GLOSSARY 

1. INTRODUCTION 

Operating System 

CP-R Terms and Processes ___ 

Job 

Task 



Load Module 

Program 

Foreground _ 
Background _ 



Terminal Job Entry System 
Temp Stacks 



Data Control Block 

Function Parameter Table 
Task Control Block 



Program Control Block 

Roll-Out/Roll-In 

Reentrant Subroutine . 

Philosophy of Operation . 
Real-Time Processing . 
Batch Processing ,.- 

CP-R Functions 



Secondary Storage Utilization 

Job Accounting 

Public Library 

Symbionts _^^__^__^__ 

Control Task 

Overlays 



Memory Protection 



Disk Write Protection 
Language Processors __ 
Service Processors 

Overlay Loader 

RADEDIT 

Edit 



Background Job Organization 
Foreground Job Organization 
Input/Output Specifications . 

Physical Device Names 

Disk File Identifiers ____ 
Operational Labels 



Resolving I/O Medium Nome 
Ambiguities 



2. CONTROL COMMANDS 



Job Control Processor 

System Control Commands 
JOB 



ASSIGN . 

LOAD 

ATTEND - 
MESSAGE 



XII 



XII 



2 
2 
2 
2 
2 
2 
2 
2 
2 
2 
3 
3 
3 
4 
4 
5 
5 
5 
5 
6 
6 
6 
6 
6 
7 
7 
7 
8 
9 
10 
11 

11 

12 

12 
13 
13 
13 
15 
15 
15 



LIST 

PAUSE . 

CC 

LIMIT _ 
STDLB _ 

ROV 

RUN 

1NIT 

SJOB _ 

BATCH 

ALLOBT 



Dump Control Command 
PMD 



Input Control Commands 

EOD 

FIN 



Utility Control Commands 

PF1L,PREC 

SFIL 



REWIND . 
UNLOAD 
WEOF _ 
DAL 



Processor Control Commands _ 
Processor Interface with CP-R 
JCP Messages 



3. OPERATOR COMMUNICATIONS 
CP-R Messages 



Trap Handler Messages _ 
Output Message Formats 

Operator Key-In 

Combined Key-Ins 

Device Control 



I/O Key-In Format 

Card Reader Messages/Key-Ins 
Card Punch Messages/Key-Ins 
Disk Pack Messages/Key-Ins _ 
Disk Data Protection - 



Line Printer Messayes/Key-Im 

Magnetic Tape Messages/Key-Ins 

4. INPUT/OUTPUT OPERATIONS 



Permanent Files ____ 

Temporary Files 

File Organization 

Blocked Files 

Unblocked Files _ 

Compressed Files _ 
Disk Access Methods 

Sequential Access . 

Direct Access ... 

Device Access 

Disk Pack Files 

Extensible Files 

I/O Queue ing 



I/O Cleanup and I/O Start 



16 
16 
17 
17 
17 
17 
IB 
18 
18 
19 
19 
20 
20 
20 
20 
20 
21 
21 
21 
21 
22 
22 
22 
22 
23 
24 

26 

26 
26 
31 
31 
40 
41 
41 
42 
42 
42 
43 
43 
43 

44 

44 
44 
45 
45 
45 
45 
45 
45 
45 
45 
45 
46 
46 
46 



Sharing DCBi Among Talcs 

Sharing I/O Devices Among Tasks 

Sharing Disk Files Among Tasks and Jobs 
I/O End Action 



Reserving I/O Devices for Foreground Use 
Device Preemption 



Direct I/C Execution (lOEX) 
Keyboard-Printer Edited I/O 

Logical Devices 

Operational Labels 



Data Control Blocks (DCBs) 
DCB Creation 



DCB Assignment 
DCB Format __ 



Error and Abnormal Conditions 
I/O System Calls ,^_^___ 

Open a File 

OPEN 



Close a File 
CLOSE _ 



Read a Data Record 
READ 



Write a Data Record 
WRITE 



Rewind, Unload, and Write EOF Functions 
REW 



UNLOAD 
WEOF _ 



File and Record Positioning Functions 
PFIL,PREC 



ALLOT, DELETE, and Truncate Functions 
ALLOT 



DELETE, TRUNCATE 



Allot or Delete Symbiont File 
JOB 



Print and Type Functions 

PRINT, TYPE 

DEVICE 



Device Control Functions 



46 

47 
47 
47 

48 
48 
48 
49 
49 
49 
49 
49 
50 
50 
54 
54 
54 
54 
55 
55 
55 
55 
56 
56 
58 
58 
58 
58 
59 
59 
60 
60 
62 
63 
63 
64 
64 
65 
66 



Check Correspondence of DCB Assignments 66 

CORRES 66 

ASSIGN 66 

GET AS N 67 

IOEX 69 

STDLB 71 

STOP10,STARTIO 72 

5. USER-TASK SCHEDULING AND OPERATION 74 



Scheduling and Loading Programs 



Loading and Terminating Foreground 
Secondary Tasks 



Queueing Primary Foreground Program 
Run Requests 



Loading and Releasing Primary Foreground 
Programs 



74 



74 



74 



. 75 
Loading and Executing Background Programs 75 

Task Control Block (TCB) 75 

Primary Task Control Block Format _^__^__ 75 

Program Control Block (KB) 76 

PCB Format 76 

User Temp Stack 77 

CP-R Temp Stack 77 



Master and Slave Modes 

Overlay Segment Operations 

Trap Handling 

CAL Handling 

Return Functions 

Interrupt Control ____^^_ 



Connecting and Disconnecting Primary 
Tasks to Interrupts 



Arming, Disarming, Enabling, and 

Disabl ing 

End-Action ____^____^^^_ 



System Function Call Formats 

KJOB 

SJOB 



SETNAME 

RUN 

RLS 

I NIT 

SCHED _ 

INT 

PC 



EXTM _ 
SIGNAL 
POLL _ 
POST _ 
ENQ __ 
DEQ _ 
TRAP _ 
JTRAP _ 
TRTY __ 
TEXIT _ 
TRTN _ 
EXIT _ 
EXDA _ 
TERM _ 



ABORT 

CONNECT, ARM, DISARM, DISCONNECT 
CALRTN 



ENABLE, DISABLE, TRIGGER 

START 

STOP 



STATUS, MODIFY 
MASTER, SLAVE . 

SEGLOAD 

WAIT 

TIME 

GETTIME 

STIMER 

ERRSEND 

ALARM 

RECALARM 



- 77 

- 77 

- 78 
_. 78 
_ 78 
_ 79 

_ 79 

_ 79 
-. 79 
-. 80 
_ 80 
_ 81 

- 82 

- 83 

- 84 
_ 84 

- 85 

- 87 

- 87 
_ 87 

- 88 
_ 90 
_ 91 
_ 92 
-. 93 
_ 94 
_ 94 
_ 95 

- 95 
_ 95 
_ 95 

- 95 
_ 95 

- 96 
_ 96 
_ 99 
_ 99 
_ 99 
.100 
_100 
-102 
_102 
-103 
_103 
-104 
-104 
_105 
-106 
-106 



6. CP-R MEMORY MANAGEMENT 



Real Memory Allocation 

CP-R System Memory 

Foreground Private Memory _ 
Foreground Preferred Memory 
Secondary Task Memory 



Primary Task Memory Allocation 

Virtual Memory Allocation 

System Virtual Memory 

Task Virtual Memory 



107 

.107 
.107 
.107 
.107 
.109 
.109 
.109 
.109 
.109 



Reserved Popes 

Access Protection _ 
Software Segmentation 
Sharing Segments 



Segment Access Protection 
Secondary Task Structures 



Linking a Program in Real Versus 
Virtual Memory 



Linking a Program using Simplified Memory 
Management 



Memory Management System Calls 
ACTIVATE 



DEACTIVATE 

ERASE 

GETPAGE _ 

RE LP AGE 

LOCK 



UNLOCK 

PREFMODE 

Roll-Out/Roll-ln 



7. ASYNCHRONOUS OPERATION CONTROL 

Check Completion 

CHECK 

DELFPT 

WAITALL 



WAITANY 
TEST 



8. CP-R DEBUG SERVICE 



Debug Call 
DEBUG 



Method of Operation 

Debug Input 

Debug Output 



Debug Trap Control 
Debug Commands 



Debug Command Syntax 

A 

C 

M 

I 

N 

P 

D 

E 

R 

B 

L 

Q 

W 



Debug Snapshot 
S 



Debug Error Message 
9. CP-R MEDIA SERVICE 



Key-In Conversions * — 
Foreground Conversions 



109 
110 
110 
112 
113 
113 

.114 

115 

115 

115 

.116 

116 

.116 

.117 

,118 

.118 

.119 

.119 



MEDIA Processing 



121 

.121 

121 

122 

123 

.124 

.124 

126 

.126 
.126 
.127 
.127 
.127 
.128 
.128 
.128 
.129 
.129 
.129 
.129 
.130 
.130 
.130 
.130 
.131 
.131 
.131 
.131 
.131 
.131 
-131 
.132 

134 

.134 
.134 



MEDIA Service Call 
MEDIA 



MEDIA Key-Ins 

Conventions 

Messages 



10. OVERLAY LOADER 

Overview 

Functional Flow _ 

Limitations _____ 



Overlay Load Modules 

Overlay Structures 

Overlay Restrictions 



Overlay Control Commands 
Syntax 



Order of Control Commands 

IOLOAD 

:ROOT 

:SEG 

:LIB 



INCLUDE . 
EXCLUDE . 
rCOMMON 
RES 



:LCOMMON 
:MODIFY _ 
ASSIGN _ 

rPUBLIB 

tLMHDR 

Program File 



Root Segments 



Overlay Segments 

Temporary Disk Files 

Loader-Generated Items 
Program Control Block 
Data Control Block _ _ 
DCBTAB 



OVLOAD Table 
Temp Stacks 



External Definitions 
Libraries 



System and User Library Libraries 

Assembly Language 

Entry Address 



System and User Libraries on Disk 



Constructing and Maintaining Library 
Public Libraries 



Calling the Public Libraries 
Library Protection 



Releasing a Public Library 
Forming a Public Library . 
Map 



Error Diagnostics „. 

User Load-Time Assigns 
M:DCB and F.-DCB _ 
Run-Time Assigns — 
Load-Time Assigns _ 

FORTRAN Interface — . 
Common Allocation 
CONNECT 



— 134 
_134 

— 134 

— 136 
._137 
—.137 



138 

__ 138 
138 

_138 
_13R 
__'39 

139 

140 

140 

_140 
_140 
142 

— 143 
_145 

— 145 
_146 
_146 
_146 

— 147 

— 148 
_149 
_149 
_150 

— 150 
_150 

151 

151 

151 

151 

151 

151 

151 

151 

— 151 

— 152 
_f52 
_ 152 
_152 
_152 

— 153 
_153 

— 153 

— 153 
_153 
_153 

— 153 

— 157 
-165 

165 

-J. 165 

— 165 

— 165 

— 165 

— 166" 



Calling Overlay Segments __ 
Main Program Name and Entry 
Labeled COMMON Names _ 
Blank COMMON Names 



Core Layout at Execution Time 



11. RADED1T 

Operating Characteristics 
File Allocation 



.166 
.166 
.166 
.166 
.166 



FORTRAN Job Examples 



.187 



Skipping Bad Tracks 



System and User Library Files 



168 

.168 
.168 
.168 
.169 



Algorithms for Computing Library File Sizes ___169 



Disk Area Protection 
Calling RADEDIT _ 
Command Formats _ 
RADEDIT Commands 

•ALLOT 

:COPY 



DPCOPY _ 
DELETE 

£LEAR 

SQUEEZE . 

TRUNCATE 
MAP 

:SMAP 

LMAP 

rCATALOG . 

DUMP 

XDMP 

SAVE 

RESTORE _ 
BDSECTOR . 
GDSECTOR 

END 

Error Messages , 



Disk Restoration Messages 



12. PREPARING THE PROGRAM DECK 
AP Examples 



Assemble Source Program, Listing Output 
Assemble Source Program, Listing Output, 
Load and Go Operations 



.170 
.170 
.170 
.170 
.170 
.171 
.172 
.173 
.173 
.173 
.174 
.174 
.174 
.175 
.176 
.176 
.177 
.178 
.178 
.178 
.179 
.179 
.179 
.179 



184 

.184 
.184 

.184 



Assemble and Load a Program Written for Un- 
mapped (RBM) Background Execution 184 

Assemble from Compressed Deck with Source 

and Updates, Listing Output 184 

Assemble Source Program, Compressed Output 

on Cards, Listing Output 185 

Assemble Source or Compressed Program in 

Batch Made, Listing Output 185 

Assemble Source Program, Compressed Output 

en Disk File.- Listing Output 185 



Assemble Compressed Deck from Disk File, 
Source Updates from Cards, Listing 
Output 185 

Assemble Source Program, Write Compressed 

Outputon9-Tr_ckTape, Listing Output ___186 

Assemble Compressed Program from 9-Track 

Tape, Listing Output IB* 



Combined FORTRAN Compilations, Plus 
FORTRAN Compile and Execute 

Compile and Execute FORTRAN Source 
Program with Re il -Time Linkages _ 

Compile and Execute Program Using LS, 
BO Default Options 



.187 



.188 



189 



Compile a FORTRAN Program and Setup for 

Execution in Foreground Area 190 

Overlay Loader Examples 191 

Botch, Using GO Links 191 

Segmented Background Job 192 

Foreground Job Examples 193 

Load and Execute Foreground Program 193 



Load and Execute Segmented Foreground 
Program _____________________________ 



194 



Load Two Foreground Secondary Programs 

Sharing a Read-and- Execute Procedure 195 

Lood Foreground Secondary Program with a 

Segment Fixed in Real Memory ■ 195 

Load Program with Dynamically-Allocated 

Segment 196 



13. LINE EDITOR (EDIT) 



Introduction 
Calling Edit 
Subject File Format 



Sequence Numbers 
File Identifiers 



Input/Output Conventions 

Multiline Records 

Break Function 

Error Response 

EDIT Commands _______ 



Command Structure 

File Commands 

EDIT 

SAVE 

END 

SEQ 

BP 



Command Stream Control 
GO and RET 



Record Editing Commands 

IN 

IS 

DE 

TY 

TC 

TS 

MD 

MK 

FD 

FT 

FS 

RN 

CM 

SE 

SS 

ST 



197 



.197 
.197 
.197 
.197 
.197 
.197 
.198 
.198 
.198 
.198 
.198 
.199 
.199 
.199 
.199 
.199 
.199 
.200 



.200 



.201 
.201 



.202 



.202 



.202 



.202 



.203 



.203 
.203 
.204 



.204 
.204 
.204 



.205 
.205 



.205 



.205 



Intr c r e cord Editing Commands 

Yand N 

CL 

S 

D 

P : 

f : 

o 

E 



.205 



Ror L 

L 

R 

A 

C 

DE _ 
TS __ 



TY 

JU 

NO 

RF 

Messages 

Edit Command Summary 



14. TERMINAL JOB ENTRY 

Terminal Executive Language 

EDIT 

MUST 



The Terminal _____ 
Terminal Operations 



Detecting and Reporting Errors 

Interrupting CP-R 

Paper Tape Input 



Summary of Teletype Functions 

Terminal Executive Language 

Major Operations 

Minor Operations 

Error Handling 

TEL Commands 

TABS 

OFF 



MESSAGE 

STDLB 

MEDIA _ 
BATCH _ 

JOB 

CANCEL 
SETNAME 

RUN 

I NIT 



DEBUG 

EXIT 

STOP 

START 

EXTM 

QUIT 

CONTINUE or GO 



206 



207 
207 
207 
207 
208 
208 
208 
208 
.208 
208 
209 
209 
209 
210 
210 
210 
210 
.211 
.211 
.211 



220 



220 



220 



220 



220 



220 



Initiating and Ending On-Line Sessions 222 

Typing Lines 222 

Typing Commands UA 



.224 



224 



225 



225 



.225 



226 



.226 



226 



226 



226 



.226 



.226 



.226 



.226 



226 



227 
.227 



.227 



.227 



227 



227 



.227 



228 



.228 
.228 



.228 



.228 



Interrupting, Resuming, and Terminating 

Executions __ 228 



MUST Operations ' 228 

TJE Account Maintenance 228 

Standard Symbols, Codes and Correspondences 229 

Standard Symbols and Codes ______________ 229 

Standard Character Sets _ 229 

Control Codes , 229 

Special Code Properties . 229 



15. SYSTEM GENERATION 



BOOT26 

SYSGENLOAD 

SYSGEN/SYSLOAD 

SYSGEN 

SYSLOAD 



Memory Allocation 
Disk Allocation 



Tables Al located and Set by SYS GE N 
Input Parameters 



SYSGEN Control Commands 
:PROC 



:MONITOR 
tRESERVE _ 

:CHAN 

:DEV1CE _ 
ALLOBT _ 

MDEF 

MOD 

.•COC 

:STDLB 

KTT1NT 

:INTLB 

:PUNCH _ 

:F1N 

:SITE 



rCOMMENT 

:SYSLD 

SYSLOAD 

MAP Option 
All Option _ 



FAST Option 

Override Option (OVR) 
Update Option 



Allocation of SP Area 



SYSGEN and SYSLOAD Alarms 

Loading System Processors and User Programs 



Introduction 

Hardware Interrupt Requirements 
Main Storage (Memory) Requirements 



Memory Space Requirements for CP-R 
Memory Space Requirements for CP-R 
Processors ■* 



Memory Space Requirement, for User- 
Foreground Programs 



Secondary Storage Requirements 
BT Area Storage Requirements 



User Secondary Storage Requirements 
Removable Disk Packs and Cartridges 



236 

238 

238 

238 

236 

238 

238 

246 

248 

249 

250 

.250 

.250 

.251 

.252 



253 
256 
256 
257 
257 
258 
258 
258 
.259 



.259 



.259 



259 



259 



.260 
.260 
.261 
.261 
.261 
.261 
.262 



262 

.262 



16. HARDWARE CONFIGURATION GUIDELINES 266 



.266 
.266 
.268 
.268 



.268 

.269 
.269 
.270 
.270 
.270 



Peripheral Equipment Requirements aid 
Options 



Additional Peripheral Options 
Miscellaneous Hardware Options 

Register Blocks 

Br On/Off 



INDEX 



A. SYSTEM CP-R 



B. 



APPENDIXES 



System CP-R Procedure References 
Default Form 



In- Line FPT Form . 

FPT-Only Form 

CAL-Only Form 

Parameter Field _ 
System CP-R Errors 
CAL-Parameter Groups 



Specific CAL-Parameter Groups 



XEROX STANDARD COMPRESSED 
LANGUAGE 



C. REAL-TIME PERFORMANCE DATA 

Response to Interrupts by Centrally Connected 
Tasks 



I/O Interrupt 



Interrupt Inhibits 



Secondary Task Dispatch Time 

Console Interrupt 

Overlay Loading 



272 
272 

272 
272 
272 

331 



273 

.273 

,273 

.273 

.273 

273 

273 

,274 

274 

.274 



289 



290 



290 

290 

290 

,290 

.290 

.290 



Troco Command FOi — iu*s _ 

Clear Command Format _______ 

I END Command Format ___________ 

System Patching and Tracing Diagnostics 



295 

296 

296 

.296 



CHARACTER-ORIENTED COMMUNICATIONS 
ROUTINES 



System Interface _______________ 

User Program Interface _____________ 

Preparation and Use of COC ________ 

COC Commands and Calling Sequences _ 
Call CSTART (Initiate COC Activity) . 
Call CSET (Set Line Table Parameters) 
Call CWRITE (Write Output to a 

Terminal) 



Call CREAD (Accept Input from a 
Terminal) 



Call CMOVE (Move Input to a User Area) 

Call CHECK (Check I/O Line Stalus) 

Call CSTOP (Terminate COC Activity) — 
I/O Interrupt Routines 



Input Interrupt Processing _ 
Output Interrupt Processing 
End-Action Processing ___ 



Special Action Processing _ 

Break Signal Handling 

Escape Sequence Processing 
COC Database 



COC Parameters 

Line Control Tables 

Line State Table Format 

Terminal Mode Table Format _____ 
Terminal Type Table (COCTERMN) 
Buffer Pool 



Standard Input/Output Translation Tables 
Input Special Action Table _________ 

Escape Sequence Tables 



D. COOPERATIVES AND SYMBIONTS 



291 



Output Conversion (EBCDIC-US ASCII) 



297 

297 
298 
298 
,298 
298 
299 

300 

301 
302 
.303 
.303 
.304 
.304 
,304 
304 
.304 
.305 



305 
305 
305 



305 



.305 
.306 
.307 
.307 



.307 



,307 

311 

.311 



Cooperative 
Symbionts 



Symbiont-Cooperative Housekeeping 



.291 
291 
291 



H. JOB MANAGEMENT 
Concept of a Job 



313 
.313 



JCP LOADER 

Loading Nonsegmented Programs 
Loading Segmented Programs 



293 I. TASK MANAGEMENT 314 

.293 Disconnecting Primary Tasks from Interrupts 314 

.293 Event Management 314 



SYSTEM INITIALIZATION AND PATCHING 



Input Options 
Quick Patches 



Patch Command Formats ... 



Patch System Overlay or JCP 

Patch Simulation Routine 

Patch CP-R Monitor 

Patch System Tables ______ 

Modify Patch Area 



294 

.294 
.294 
.295 
.295 
.295 
.295 
.295 
.295 



J. RESOURCE MANAGEMENT 

K. PERIODIC SCHEDULING 

L. ERROR LOGGING 

M. SYSTEM ALARM PROCEDURES 



316 
318 
319 
320 



N. CP-R SERVICE CALLS 



O. ERROR AND ABNORMAL CODES 



Type Completions (TYC) 
Error Codes 



P. VOLUME INITIALIZATION 



Introduction 



Loading VOL1NIT _ 
VOLINIT Commands 



FIGURES 



1. 

2. 
3. 
4. 
5. 
6. 

7. 
8. 

9. 

10. 

11. 

12. 

13. 

14. 

15. 

16. 

17. 

18. 

19. 

20. 

21. 



Overlay Structure 



Loading Overlay Loader from Cards 
Display Format 



Error Summary Example 
Task Status Format 



User Temp Stack Format at CAL Processor 
Entry 



TCB far Centrally Connected CALs 



Example of Memory Organization for 
64K System 



CP-R System Memory 



Virtual Memory Organization 
Segment States 



Tree Structure Options 
An Overlay Program _ 
Overlay Example 



Object Module from GO File 
:UB Command Usage 



EXCLUDE Command Usage 
DSECT Allocation Example 



tMODIFY Command Items Example 
Typical PROGRAM Map 



321 



322 

322 
322 



328 

328 
328 
328 



Blank COMMON Allocation by Default 



7 
16 
40 
40 
41 

98 
98 

108 

108 

110 

.112 

.113 

139 

.144 

.145 

.145 

.146 

.147 

.149 

.155 

.165 



22. 
23. 
24. 
25. 
26. 
27. 
28. 
29. 
30. 
31. 

32. 
33. 
34. 



Blank COMMON Option 



Standard Core Layout of a fYogro— 



Permanent Disk Area Before Squeezing 
Permanent Disk Area After Squeezing . 

MAP SP Output Example 

A Multiline Record 



Model 33 Teletype Terminal Keyboard 

SYSGEN Map Example 

Disk Allocation Example 



Linking the CP-R System Processors 
(Abbreviated) _________ 



CP-R Lowest-Cost, Minimum Configuration 
Typical Configuration 



CP-R Disk File Management 



A-l. Specific CAL-Parometer Groups 



D-1. Information Flow Through Cooperative 
and Symbionts _____________ 



1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 

10. 

11. 

12. 

13. 

14. 



TABLES 
I/O Device Type Codes _ 



Channel or Cluster/Unit Designation Code 

Device Designation Codes 

Disk Area Codes 



System Operational Labels 
JCP Messages 



CP-R Messages and Responses 
Standard Operator Key-Ins _ 
Terminal Job Entry Key- Ins _ 
Symbiont Key-Ins _______ 



Media Conversion Key-Ins 
System DCBs 



Line Printer Format Control Codes 
IOEX Function Status Returns 



166 
167 
169 
169 
175 
198 
221 
239 
247 

265 
.266 
.267 



.271 
.274 

.292 



8 

8 

8 

9 

9 

24 

26 

32 

37 

58 

39 

50 

52 

70 



IX 



15. 
16. 

17. 
18. 
19. 
20. 
21. 
22. 
23. 
24. 
25. 
26. 
27. 
28. 
29. 
30. 
31. 
32. 



Segment States Relative to o Task 



111 



Real end Virtual Memory Program Linkage _____ 1 14 

toll-Out Levels 120 

Debug Error Messages 132 

Overlay Loader Diagnostics ______________ 157 

RADEDIT Error Messages 179 

Disk Restoration Messages 182 

Edit Messages 21 1 

Edit Command Summary ___——__ 213 
On-Line User Processors 220 



Summary of Teletype Services 



.225 



CP-R 8-Bit Computer Codes (EBCDIC) 



.230 



CP-R 7-Bit Communication Codes (ANSCI1) 231 

CP-R Symbol-Code Correspondences 232 

AtSlSCIl Control -Character Translation Table 236 

Disk Area Default Sizes 247 

GO, OV, X1-X9 Default Sizes 248 



System Device Model Numbers and 
Parameters (Disk Devices) ___ 



33. 

34. 
35. 
36. 

37. 

F-l. 

G-l. 

G-2. 

G-3. 

G-4. 

G-5. 

G-6. 

G-7. 

O-l. 

0-2. 

0-3. 



System Device Model Numbers and 
Parameters (Non-Disk Devices) 



.255 



SYSGEN and SYSLOAD Alarm Messages 262 

btterrupt-Structure Summary __ ________ 268 



Processor Availability in Sample 
Configuration ________ 



Comparison of Secondary Storage 
Devices 



System Patching Diagnostics 

COC I/O Commands 

COC Parameters 



Line Control Table Items 
Input Translation Table . 
Input Conversion _____ 



Special Action Table 



Output Conversion (EBCDIC-USACII) 
Type Completion Codes 



Monitor Error and Abnormal 
Codes 



.254 



TYC, BUSY, and R10, Byte 
Settings _____________ 



,268 

.269 
.296 
.298 
.305 



_306 
-308 



.308 



.309 
.312 
.322 

.323 

.327 



PREFACE 



This manual is the principal source of reference information for the real-time and batch processing features of CP-R 
(i.e., job control commands, system procedures, ]/0 procedures, program loading and execution, hardware inter- 
rupt and software interface, and service processors). The purpose of the manual is to define the rules for using back- 
ground processing, real-time features, hardware mapping, and virtual memory capabilities. Manuals offering other 
levels of information regarding CP-R features are outlined below. 

• The Control Program for Real-Time (CP-R)/User's Guide, 90 30 87, describes how to use the various batch and 
real-time features that are basic to most installations. It presents the information in a temitutorial format that 
offers the user a job-oriented approach to learning the features of the operating system. 

e The Control Program for Real-Time (CP-R/OPS Reference Manual, 90 30 86, is the principal source of reference 
information for CP-R computer operators. It defines the rules for operator communication with the system (i.e., 
key-ins and messages) system start-up and initialization, job and system control, peripheral device handling, 
and recovery procedures. 

e The Control Program for Real-Time (CP-R)/Systems Technical Manual, 90 30 88, describes the internal func- 
tions of the operating system. It is intended for use with the listings supplied with each CP-R system for pur- 
poses of system maintenance. 

• The Availability Features (CP-R) Reference Manual, 90 31 10, describes the availability features that will 
rapidly identify a system problem as to either hardware or software malfunction and then further define the 
problem via software diagnostic criteria. 

Information for the language and applications processors that operate under CP-R is also described in separate man- 
uals. These manuals are listed in the Related Publications page of this manual. 



COMMAND SYNTAX NOTATION 



Notation conventions used in command specifications and examples throughout this manual are listed below. 



Notation 


Description 


lowercase letters 


Lowercase letters identify an element that must be replaced with a 
user-selected value. 




CRndd could be entered as CRA03. 


CAPITAL LETTERS 


Capital letters must be entered as shown for input, and will be printed as 
shown in output. 




DPndd means "enter DP followed by the values for ndd". 


[] 


An element inside brackets is optional. Several elements placed one under 
the other inside a pair of brackets means that the user may select any one or 
none of those elements. 




[KEYM] means the term "KEYM" may be entered. 


1) 


Elements placed one under the other inside a pair of braces identify a re- 
quired choice. 




| . , | means that either the letter A or the value of id must be entered. 


• « • 


The horizontal ellipsis indicates that a previous bracketed element may be 
repeated, or that elements have been omitted. 




mme[, name]. . . means that one or more name values may be 
entered, with a comma inserted between each name value. 


• 


The vertical ellipsis indicates that commands or instructions have been 
omitted. 




MASK2 DATA, 2 X'lEF' 

means that there are one or more state- 

BYTE DATA, 3 BA(L(59)) m . ents omitted between the two DATA 

directives. 


Numbers and 
special characters 


Numbers that appear on the tine (i.e. , not subscripts), special symbols, and 
punctuation marks other than dotted lines, brackets, braces, and underlines 
appear as shown in output messages and must be entered as shown when input. 




(value) means that the proper value must be entered enclosed in 
parentheses; e.g. , (234). 


Subscripts 


Subscripts indicate a first, second, etc. , representation of a parameter that 
has a different value for each occurrence. 




sysid],sysid2fty*id3 means that three successive values for sysid 
should be entered, separated by commas- 


Superscripts 


Superscripts indicate shift keys to be used in combination with terminal keys, 
c is control shift, and s is cose shift. 




L a means press the control and case shift (CONTROL and SHIFT) and 
the L key. 


Underscore 


All terminal output is underscored; terminal input is not. * 




IRUN means that the exclamation point was sent to the terminal, but 
R~UN was typed by the terminal user. 


©©© 


These symbols indicate that an ESC (©), carriage return (©), or line feed 
(0) character has been sent. 




IEDTT ©means that, after typing EDIT, a carriage return character 
h"as been sent. 
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GLOSSARY 



active foreground program a program is active if ft is 
resident in memory, connected to interrupts, or in the 
process of being entered into the system via a IRUN 
control command. 

asynchronous events independent events that may be 
taking place concurrently to task execution (e.g., 
a read from mognetic tape or an STIMER service 
call). 

background area that area of core storage allocated to 
batch processing. This area may be checkpointed for 
use by foreground programs. 

background program any program executed under moni- 
tor control in the background job. These programs are 
entered through the batch processing input stream. 

batch job a job that is submitted to the batch job stream 
with an operator keyin or through an on-line terminal 
(using the BATCH command). 

binary input input from the device to which the BI 
(binary input) operational label is assigned. 

centrally connected interrupt an interrupt that is con- 
nected to a monitor interrupt routine that first saves 
the environment of the system and then switches the 
environment to that of the task that gets control when 
the interrupt occurs. 

checkpointed job a partially processed background job 
that has been saved in secondary storage along with 
all registers and other "environment" so that the 
job can be restarted when a foreground task no 
longer requires the borrowed background memory 
and all currently active foreground activity has 
completed. 

control command any control message other than a 

key-in. A control command maybe input via any de- 
vice to which the system command input function has 
been assigned (normally a card reader). 

control message any message received by the monitor 
that is either a control command or a control key-in 
(see "key-in"). 

cooperative a monitor routine that transfers information 
between a user's program and disk storage (also see 
*%ymbiont"). 

Data Control Block (DCB) a table in the executing pro- 
gram that contains the information used by the monitor 
in the performance of an I/O operation. 

dedicated memory core memory locations reserved by 
the monitor for special purposes such as traps, inter- 
rupts, and real-time programs. 



directly connected interrupt an interrupt which, when 
it occurs, causes control to go directly to the task; 
e.g., execution of the XPSD instruction in the inter- 
rupt location gives control to the task rather than first 
going to a monitor interrupt routine. 

disk pack a secondary storage system of removable ro- 
tating memory. For C P-R purposes, disk pack and RAD 
are synonymous unless otherwise noted. 

dispatcher a set of CP-R routines that schedule sec- 

ondary tasks on a software priority basis. There may 
be more than one dispatcher in a given system. 

dummy section a type of program section that provides 
a means by which more than one subroutine may refer- 
ence the same data (via an external definition used as 
a label for the dummy section). 

end record the last record to be loaded in an object 
module or load module. 

error severity level code a four-bit code indicating the 
severity of errors noted by the processor. This code 
is contained in the final byte of an object module. 

execution location a value defining the origin of a re- 
locatable program, to set the address at which program 
loading is to begin. 

external definition a symbolic name that is declared to 
be "knowoble " outside the range of the object module 
in which it is defined; a "global" symbol. An external 
definition allows the specified symbolic name to be used 
in external references (see below). 

external reference a reference to a declared symbolic 
name that is not defined within the object module 
in which the reference occurs. An external refer- 
ence can be satisfied only if the referenced name 
is defined by an external definition in another ob- 
ject module. 

file management routines monitor routines that interpret 
and perform l^O functions. 

foreground area that portion of memory dedicated speci- 
fically for foreground tasks and programs. 

foreground program a load module that contains one or 
more foreground tasks. "* 

foreground task a body of procedural code that is asso- 
ciated with an interrupt (primary task)or controlled by 
a CP-R dispatcher (secondary task). 

Functional Parameter Table (FPT) a table through which 
a user's program communicates with a monitor function 
(such as an I/O function). 



GO file a temporary disk file of relocatable abject 
modules fanned by o processor. 

granule a block of disk sectors containing a specified 
number of words. 



idle state the state of the monitor when it is first 
loaded into core memory or after encountering a I FIN 
control command. The idle state is ended by means 
of a IC key-in. 

installation control command any control command used 
during system generation to direct the creation of a 
CP-R system. 

job a job is a collection of one or more related tasks. 
A foreground job is composed of one or more related 
foreground tasks. A background job is composed of 
one or more job steps each comprised of a single task. 
Tasks executed in the background are not connected 
to interrupts. Background job steps are processed 
through the batch input stream. The job concept is 
used for resources fcuch as files or devices) that are 
shared at the job level. 

key-in , control information entered by the console op- 
erator via a keyboard. 

keyword a word, consisting of from one to eight char- 
acters that identifies a particular operand used in a 
control command or operator key- in. 

load item in object modules, a load-control byte fol- 
lowed by any additional bytes of load information per- 
taining to the function specified by the control byte. 

load map a listing of significant information pertaining 
to the storage locations used by a program. 

load module an executable program formed by using 
relocatable object modules (ROMs) and/or library 
object modules as source information. Primary load 
modules contain one or more primary tasks; secondary 
load modules contain a single secondary task. 

logical device a peripheral device that is represented 
in a program by an operational label (e.g., BI or BO) 
rather than by a specific physical device name. 

long wait when a secondary task performs on asyn- 
chronous service with wait, the task may specify 
that the WAIT is to be 'long-wait'. Long wait 
tasks are selected for roll-out before non long-wait 
tasks, overriding the strictly priority driven roll-out 
algorithm. 

monitor a program that supervises the processing, load- 
ing, and execution of other programs, i.e., the con- 
trot program. 



object deck a card deck comprising one or more object 
modules and control commands. 

object language the standard binary language in which 
the output of a compiler or assembler is expressed, 

object module the series of records containing the load 
information pertaining to a single program or subprogram. 
Object modules serve as input to the Overlay Loader 
to form the load module. 

operational label a two-character symbolic name used 
to identify a logical system device. 

option an elective operand in a control command or 
procedure call, or an elective parameter in a Function 
Parameter Table. 

OV file is a temporary disk file that contains an exe- 
cutable program formed by the Overlay Loader if a 
program file name was not specified at load time. 
Used primari ly to test new programs or new versions 
Or programs. 

Overlay Loader a processor that links elements of over- 
lay programs (ROMs) and forms executable programs. 

overlay program a segmented program in which the 
segment currently being executed may overlay the 
core storage area occupied by a previously executed 
segment. 

parameter presence indicator a bit in word 1 of a 
Function Parameter Table that indicates whether a 
particular parameter word is present in the remainder 
of the table. 

physical device a peripheral device that is referred to 
by a name specifying the device type, I/O channel, 
and device number (also see "logical device"). 

postmortem dump a listing of the contents of a specified 
area of core memory, usually following the abortive 
execution processing of a program. 

primary reference an external reference that must be 
satisfied by a corresponding external definition (capa- 
ble of causing loading from the system library). 

primary task a body of code that is connected to a hard- 
ware interrupt and that gains control of the CPU 
when that interrupt becomes active. 

Program Trap Conditions (PTC) two words that indi- 
cate trap status (wt or reset) and trap exit address 
respectively. 

Relocatable Object Module (ROM) a program, or sub- 
program in the form generated by a standard processor 
such as Macro-Symbol, FORTRAN, etc. 

resident program a program that has been loaded into a 
dedicated area of core memory. 
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ROM Relocatable Object Module ^ee above). 

secondary reference on external reference that may or 
may not be satisfied by a corresponding external defi- 
nition (not capable of causing loading from the system 
library). 

secondary storage any rapid-access storage medium 
other than memory (e.g., RAD or disk pack). 

secondary task a body of code whose execution is sched- 
uled by a CP-R dispatcher. 

segment loader a monitor routine that loads overlay seg- 
ments from disk storage at execution time. 

source deck a card deck comprising a complete program 
or subprogram in symbolic EBCDIC format. 

source language a language used to prepare a source 
program (and therefrom a source deck) suitable for 
processing by an assembler or compiler. 

symbiont a monitor routine that transfers information 
between diskstorage and a peripheral device indepen- 
dent of and concurrent with job processing. 

symbolic input input from the device to which the SI 
(symbolic input) operational label is assigned. 



symbolic name an identifier that is associated with some 
particular source program statement or item so that sym- 
bolic references may be made to it even though its 
value may be subject to redefinition. 



events that must take place 



synchronous events 
sequentially. 

system library a group of standard routines in object 
language format, any of which may be included in a 
program being created. 

task see 'primary task "and 'secondary task". 

raskname identical to a load module name (Imn) unless 
redefined by the SETNAME CAL. All tasks within a 
load module have the same raskname. 

temp stack push-down stacks created by the Overlay 

Loader and used by the monitor and system library routines. 

time-sliced secondary tusks may be 'time-sliced' in 
which case CP-Rwill cause the task to relinquish con- 
trol of the CPU after having executed for a defined 
period of time (a quantum of usually 100 milliseconds). 
After the expiration of a task's quantum the task is 
placed at the end of the CP-R dispatch queue in pri- 
ority order. This in effect causes time-sliced tasks of 
equal priority to be selected for execution in a 'round- 
robin' fashion. The default priority for time-sliced 
tasks is X'FFFF'. 
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1. INTRODUCTION 



OPERATING SYSTEM 



TASK 



The Xerox Control Program for Real-Time (CP-R) for Xerox 550 
and Sigma 9 Computers it the major control element in 
an installation's operating system. Operating in a real-time 
environment, CP-R provides for concurrent background/ 
foreground processing with emphasis on foreground operations. 

The operating system consists of CP-R, language translators, 
service programs, batch (background) user's programs, ter- 
minal job entry system, and real-time (foreground) user's 
program. In general, CP-R governs the order in which 
the other programs are executed and provides services 
common to all of them. 

The number, types, and version of programs in an oper- 
ating system vary, depending upon the exact requirements 
at a particular installation. Each operating system shou Id 
consist of a closely integrated set of service and control 
routines and processing programs specifically 'tailored' for 
a given range of applications. 

As the requirements of an installation increase, the oper- 
ating system can be enlarged, modified, or updated. The 
ability to adapt to new requirements is inherent in the sys- 
tem design. Once a system is generated, it can quickly 
be expanded to include users' programs, data, and system 
libraries. 

A user's program and data may either be temporarily in- 
corporated in the operating system or remain a part of the 
system for an extended period of time. 

The operating system is self-contained and requires oper- 
ator intervention only under exceptional conditions. Op- 
erating procedures are given in the CP-R/OPS Reference 
Manual, 90 30 86. 



A task is a body of procedural code that is capable of 
gaining control of the CPU. A primary task is one that is 
associated with a specific interrupt and gains control of the 
CPU when that interrupt becomes active. A secondary task 
gains control of the CPU when scheduled by a CP-R soft- 
ware dispatcher. 



LOAD MODULE 

A load module is a body of procedural code and data that 
is identifiable by name. A load module is created at link- 
edit time by the Overlay Loader (OLOAD)from object mod- 
ules, and exists after the link-edit operation in memory- 
image form on disk storage. A load module is identified 
by name so that it may be loaded or terminated on request. 
Background load modules are loaded by control commands; 
foreground load modules can be loaded or terminated upon 
request through operator key-in, control command, or a sys- 
tem call from a foreground task. 

Load modules when loaded into memory become tasks and 
retain the identification of the lood module as their task- 
name. Primary modules may contain more than one primary 
task by virtue of multiple connections to interrupts. Secon- 
dary load modules always contain only a single task. 



PROGRAM 

For the purposes of this manual a program is synonymous 
with a load module. 



CP-R TERMS AND PROCESSES 

The following items are either unique to the CP-R system 
or have specific meaning within the CP-R context. Terms 
and processes not defined below are fully explained in the 
appropriate chapter. 



FOREGROUND 

The foreground is the set of all tasks in the system that are 
typically associated with real-time processes and are speci- 
fically not executing in the background job. The activa- 
tion sequence of foreground tasks is controlled on a pri- 
ority basis by the hardware-interrupt system and the CP-R 
software-scheduling services. Foreground tasks are guaran- 
teed memory protection from background processes. 



JOB 



A job is a collection of one or more tasks which the user has 
specifically organized to shore resources (e.g., operational 
label definitions, nonsharable peripherals, file table en- 
tries). A job may be initiated (SJOB)and terminated (KJOB) 
by system service calls or operator key-in. Each job in 
CP-R is associated with a user supplied account name. 



BACKGROUND 

The background is a job in which noncritical tasks can 
execute so as to use any available CPU time after the 
real-time requirements are satisfied. In contrast to fore- 
ground tasks, background tasks are executed serial ly and 
their sequence is controlled by control commands. They 
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may be thought of as connected to the 'null' Interrupt 
level, below that of all other tasks in the system. 

TERMINAL JOB ENTRY SYSTEM 

Terminal Job Entry (TJE) is a terminal support system that 
fulfills the user's need for local and remote job entry, A 
user may log-on, create files, edit files, submit batch jobs, 
build multi-task environments and debug the environment 
via the terminal. TJE is a real-time system that allows the 
user to create any foreground structure required. 



TEMP STACKS 

Temp stacks are sets of memory locations allocated by 
the Overlay Loader; one of which is used for dynamic 
temporary storage for system functions and the other when 
FORTRAN Library subroutines are called. The latter set 
of memory locations is also available as temporary stor- 
age for the user. The temp stacks are 'push down" stacks, 
that is, they operate in a last-in/first-out fashion, and 
are allocated to a load module. 



DATA CONTROL BLOCK 

A DCB is a table located in the calling program that contains 
information used by CP-R in the performance of an ]/0 op- 
eration. DCBs are the means by which L^O information is 
communicated between a user's program and the system. 
The information required for a particular I/O operation is 
either contained in the associated DCB or is given in a call. 
The specific information needed for an I/O operation depends 
on the organization of the data involved and the type of op- 
eration to be performed. 

The device used for I/O operation is determined by the 
contents of the associated DCB when the L/O operation is 
requested by the executing program. 

There are both system DCBs and user-created DCBs. The 
system DCBs need only be coded as external references in 
a system processor or user program; the Overlay Loader will 
satisfy these external references at link time by furnishing 
a copy of the appropriate DCBs in the program's root. If a 
user is not satisfied with the standard DCB parameters fur- 
nished by the Overlay Loader, the system DCBs can be 
coded into the user program's root and the DCB name de- 
clared as an external definition. 

FUNCTION PARAMETER TABLE 

An FPT is a table through which a program communicates 
with a system service function. 



TASK CONTROL BLOCK 

A task control block (TCB) is a table containing task- 
associated parameters. The space for this table is allo- 
cated by the system for secondary tasks and by the user 



for primary tasks. The entries in this table are used and 
maintained by CP-R. 

PROGRAM CONTROL BLOCK 

The PCB is a table containing program-associated parameters. 
The PCB is constructed by the Overlay Loader at link time. 



ROLL-OUT/ROLL-IN 

Roll-out is the process by which the memory resources ac- 
quired by a low-priority task (foreground or background) is 
made temporarily available for use by a higher-priority task. 
This is accomplished by saving an 'in-memory' image of the 
task and its context on secondary storage while its memory 
space is required for higher-priority task. 

Roll-in is the process by which a rolled-out task is restored 
to memory. This is accomplished by bringing the rolled-out 
task image back into memory, on a priority basis, whenever 
sufficient memory resources are available. 



REENTRANT SUBROUTINE 

A reentrant subroutine can be called by several different 
tasks. During execution of such a subroutine, a higher pri- 
ority task can interrupt and call the same subroutine. When 
the higher priority task has completed execution, control is 
returned to the subroutine at the interrupted point. Since 
a reentrant subroutine does not perform any instruction 
modification and uses the temp stack or a virtual -memory 
nonshared context segment for scratch storage, processing 
continues as though the subroutine had never been reentered. 



PWLOSOPHY OF OPERATION 

The system provides for two levels of operation: 

1. Real-time, foreground processing. 

2. Batch, background processing. 

REAL-TIME PROCESSING 

Real-time processing, the most critical aspect of multi- 
usage, involves reacting to external events (including clock 
pulses) typically within microseconds. -4 

Real-time programs can be either automatically loaded 
every time the system is booted from secondary itorage or 
loaded and initiated as needed. The first method is used 
when the real-time process normally remains unchanged and 
is constantly operative. The second approach is used when 
real-time operations are executed periodically or irregu- 
larly, as in an experimental laboratory. 



Philosophy of Operation 



A real-*ime process is assigned machine facilities on a 
dedicated basis at initiation time. These facilities include 
disk and memory residency, I/O channels, peripheral de- 
vices, and external interrupt lines. Such allocation re- 
mains in force until either the process orthe computer operator 
terminates the program. 

During SYSGEN, a user can reserve a portion of his fore- 
ground area for communication between primary real-time 
programs. Locations in this area are called foreground 
mailboxes. The start of this area can be referenced through 
the system label FP:MBOX. Upon encountering an external 
reference to FP;MBOX, the Overlay Loader will satisfy 
standard symbolic references to a mailbox area. 

The system provides foreground programs with the facility 
for direct I/O operations (called IOEX operations), wherein 
the user furnishes the basic hardware commands and does the 
necessary error checking and recovery. This type of I/O 
operation provides decreased overhead and greater flexi- 
bility as compared to indirect I/O operations. 

Foreground programs can be loaded for execution from a 
background job stack by operator key-in, by terminal fob 
entry commands, or through a system call by a foreground 
program, providing the program to be loaded is already on 
secondary storage in load-module format. Foreground pro- 
grams are responsible for initializing the interrupt system 
and connecting tasks to interrupts. Foreground tasks can be 
processed compatibly and concurrently with a background 
production job stack. 



BATCH PROCESSING 

The system is capable of processing a continuous series of 
background jobs with little operator intervention. Re- 
ducing the need for operator participation ensures faster 
throughput, and makes operations less subject to error. 



CP-R FUNCTIONS 

CP-R controls and coordinates batch (background) and 
real-time (foreground) processing. Efficient operation 
is assured by minimizing system overhead in response to 
an interrupt, and by preserving the relative priority of 
the tasks. 

Reentrant service functions perform I/O and control the 
interrupt system; other service functions load and initial- 
ize foreground tasks. 



Some portions of CP-R are resident to ensure continuous 
operation. Other portions of CP-R ore brought into main 
memory from secondary storage as required to perform specific 
functions. These portions ore structured as overlays, thus 
minimizing main memory requirements. In addition, proc- 
essing programs are retrieved from secondary storage and 
they too can capitalize on overlay techniques to minimize 
main memory requirements. 



Secondary scratch storage for service programs, processors, 
and user programs Is provided, and secondary storage also 
accommodates permanent user files. (Permanent user files 
on secondary storage are acquired through a processor called 
RADEDIT which provides media conversion, listing of files, 
and other services in addition to file allocation. ) 



SECONDARY STORAGE UTILIZATION 

A disk storage unit is essential for operation of the system. It 
minimizes main memory requirements by storing all system, 
processor, and user-program overlays, yet provides very fast 
access whenever an overlay is called into memory. 



DISK AREAS 

During system generation, secondary storage is divided into 
large blocks called disk areas. These areas represent func- 
tional groupings of disk files. All files within a given area 
have the same software write protection. Since the entire 
CP-R system is disk oriented, every job will directly or in- 
directly involve the use, modification, allocation, or release 
of disk files. Listed below are the standard disk areas and 
the types of files that normally occupy them. 

e System Program (SP) area contains CP-R, the Account 
Inventory file, the Scheduler file, and the set of lan- 
guage translators used by the local installation, such as 
AP and FORTRAN. The area also contains the System 
Library (i.e., FORTRAN Library/Run-time), and 
RADEDIT and Overlay Loader service processors. All 
translators and service processors are called by user to 
execute in the background. 

e Foreground fVogram (FP) area contains a collection of 
foreground programs and an optional user library and 
Public Libraries. User-library routines are included in 
the user's load module at "link time", fvblic Libraries 
are groups of run-time, reentrant routines shared by a 
number of programs. 

e Background Program (BP) area contains the set of per- 
manent user programs that execute in the background. 

e User areas (any two-character name) allow flexible sub- 
division of the disk space to aid the individual instal- 
lation in controlling disk storage use. User disk areas 
provide both use control and file name uniqueness for 
the files within them. Use control is determined by the 
area protection type. This maybe public, background, 
foreground, system, or IOEX. Public and background 
areas may be read or altered by either background or 
foreground users. Additionally, pubfic areas provide a 
pool of space for area-independent file activity. Nor- 
mally, foreground areas may be altered only by fore- 
ground users, and system areas may not be altered. 
However, both types may be read by any user. IOEX 
areas may be used only by IOEX (Direct Device Control) 
services. Files may not be defined in them. File name 
uniqueness is determined by the combination of file name, 
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disk file account name, and dale area nam*. This 
allows ttvtral files to b« defined with the tarn* name 
and account, as long a they ant In different dak areas. 
(The data areas, 01 through DF, or* considered to be 
user areas.) 

Checkpoint (CK) area is used by CP-R for roll-out/ 
roll -in file storage and to save an image of memory 
after a system alarm condition. 

input Symbiont (IS) and Output Symbiont (OS) areas 
contain files that are defined and maintained by sym- 
biont routines. Files in the IS and OS areas can not 
be accessed by users. 

IOEX Access (XA)orea contains no directory and hence 
no files. This area can be written only by IOEX and 
should normally be the only area of the disk that IOEX 
is allowed to access. 

Background Temp (BT) area contains temporary (scratch) 
files (XI through Xn where n is a SYSGEN parameter) 
used by background programs for intermediate storage 
in processing. Their use is identical to scratch tapes on 
magnetic tape units. Temp files ore automatically de- 
stroyed when a new !JOB command is encountered in a 
job stack, and thus there is no way to save data on temp 
files from one |ob to another. They may, however, be 
saved across job steps. 

The GO and OV files are special temporary files in 
the BT area. The GO file receives relocatable object 
modules (ROMs) formed by a language processor if the 
GO option was specified or by default. It is used by 
FORTRAN IV and AP programs. The OV file receives 
executable programs formed by the Overlay Loader, 
and is used primarily to test a new program that has no 
permanent file defined, or to test a new version of a 
program without destroying the current version. A pro- 
gram in the OV file is called for execution via an 
IROV control commend. 

Note that both GO and OVare used for communication 
between job steps but not jobs. There is no monitor pro- 
tection for these files between one job and another. 



ACCOUNTING 



Background job accounting isan option selected at SYSGEN. 
To correctly colculate the elapsed time for a background job, 
all primary foreground tasks must be centrally connected (see 
"Connecting Real-Time Tasks to Interrupts" in Chapter 4). 
Otherwise, the foreground task's execution time will be in- 
cluded in the elapsed time of the background job. 

At the beginning of a background job, the date and start 
time (m hours and minutes) will be logged on the LL device. 
At the and of a background job, the total CPU time of the 
fob (in hours, minutes, and seconds) will also be logged on 
LL. This information plus the occount number and user name 
b then written on the"AL" file in the Background Data area 



of the disk. The "AL" file must be defined via the RADEDIT; 
it must be in the D1 area of the disk, and allocated a mini- 
mum size of 256 words. This file can be purged periodically 
by the operator. 

The Account Inventory (AI) file located in the SP area is a 
blocked file containing 80-byte records which represent the 
authorized accounts and user names in a given system. The 
account and user name records in the file must be arranged 
alphabetically with occount records preceding user name 
records. An occount record contoins the account name (1 
to 8 EBCDIC characters) beginning in column 1. The user 
name record contains the account name beginning in column 1 
followed by a comma followed by the name field (ltol2 
EBCDIC characters). One or more user name records may 
follow an account record. Both account and user name 
records must have EDIT line numbers in columns 73-80. 

For example: 
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The A] file is used to validate the TJE user's log-on infor- 
mation. It is also used to validate the account and user 
name supplied on a background JOB card. 



PUBLIC LIBRARY 

If a CP-R system has several programs that share a group of 
subroutines, this set of subroutines can be collected in main 
memory in a "Public Library". This preselected set is loaded 
by the Overlay Loader into a previously defined file on the 
disk. The Loader also writes the names and entry points of 
all the routines into the same disk file. Then, whenever the 
Overlay Loader loads a foreground or background program 
that references one of the "public" routines, it links the ap- 
propriate branch to the Public Library copy instead of load- 
ing a separate copy. This can represent a considerable saving 
in space for a large system. An installation may define as 
many Public Libraries as needed. + 

4ft 

If the appropriate Public Library is not presently resident 
it will be automatically loaded into its specified location 
whenever a program is loaded that uses it. If the Public 
Library is for secondary (mapped) tasks, it may include a 
common-virtual context segment that is loaded into dif- 
ferent real space for eoch task using it, i.e., a nonshared 
context segment. 
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SYMBIOMTS 

Symbiont routines transfer data from the card reader to disk 
storage and from disk storage to the line printer. Input co- 
operatives intercept card read commands in user programs 
and transfer data from disk storage where it has been stored 
by symbiont routines. Output cooperative routines intercept 
output directed from user programs to a line printer and 
transfer the data to disk storage. Symbiont service is avail- 
able only to background jobs. 



CONTROL TASK 

The CP-R Control Task performs the following functions: 

1 . "I/O cleanup" and "I/O start" when any of these func- 
tions are deferred from the I/O interrupt task because 
of priority considerations. 

2. Loading, initialization and release of primary fore- 
ground tasks. 

3. Sequencing of background programs. 

4. Console interrupt and operator key-in processing. 

5. Dumps for the background and operator. 

6. Error Log filing. 

7. Scheduling for periodic initialization of primary and 
secondary foreground tasks. 

The CP-R Control Task is connected to the lowest priority 
dispatcher in the system at system generation time. 



OVERLAYS 

A large portion of the control program is overlayed to mini- 
mize main memory residence requirements. The overlays 
may beselectivelySYSGENed as resident in order to enhance 
system performance on an installation-specific basis. 

MEMORY PROTECTION 

CP-R provides memory protection for all input operations 
•xcept direct input, and provides write protection for disk 
files. The hardware write-lock and access-control features 
furnish memory protection for all non-I/O operations. 

CP-R provides two levels of memory protection against 
faulty secondary (mapped) tasks, and one level of memory 
protection against faulty primary (unmapped) tasks: 

• Memory accesses by secondary tasks are controlled 
both by means of the hardware write-lock feature and 
the occess-protection'feature associated with the mem- 
ory map. 



• Memory accesses by primary tasks are controlled by 
the write-lock feature. 

» 
For Hie purposes of write-lock protection, real memory is 
divided —at SY5GEN —into a variable number of parti- 
tions; each partition falls into one of four classes of mem- 
ory, as follows: 

• System memory: used exclusively by CP-R and given 
a write lock of 1 1 . (One partition only. ) 

• Foreground private memory: used exclusively by pri- 
mary tasks and given a write lock of 10. 

• Foreground preferred memory: used by both primary 
tasks and secondary tasks, and given a write lock 
of 00 (i.e., unlocked). 

e Secondary task memory: used by secondary tasks only, 
both foreground and background, and given a write 
lock of 01. 

The several kinds of tasks that are possible under CP-R are 
given a write key based on the classes of memory that they 
ore allowed to access (with respect to write-lock protec- 
tion only): 

• Control -program services execute with a "'skeleton" 
write key of 00, and thus can modify memory of any 
class. 

e Primary tasks execute with a write key of 10, and can 
modify private and foreground-preferred memory only. 

• Secondary tasks, both foreground and background, exe- 
cute with a write key of 01 andean modify foreground- 
preferred and secondary-task memory only. 

For secondary tasks, which always execute in mapped mode, 
the hardware memory map affords an additional level of 
protection. The map effectively prohibits such a task from 
referencing any odd r ess outside its assigned virtual range 
and therefore completely protects all real memory not allo- 
cated to it. Further, through the assignment of access- 
control codes (read only, read/execute, read/write/execute 
to each of the virtual pages assigned to a task, the system 
automatically prevents undebugged programs from accident- 
ally executing invalid types of access, e-g., from executing 
in a data-only section, or from writing into a procedure- 
only section. Memory-access control codes are assigned 
jointly by the user and the system. 

Background tasks causing protection violations are aborted. 
Foreground programs are aborted unless they have requested 
trap control (see TRAPS system call). 

Memory protection on all input operations performed via 
service functions (except lOEX) is guaranteed by the soft- 
ware. The system checks the validity of Hje input area on all 
read operations to ensure that the area fc wholly contained 
in the calling program's write-lock area. If an attempt is 
made to read into an invalid area of main memory, an error 
condition is returned to the error address specified by the 
user. If no address is specified, the job is aborted. An "FG" 
key-in is required before a foreground program can be loaded 
from the background job stack; this protects the foreground 
from an error in a background job stack. 
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MSX WRITE MOTECTMW 



SERVICE PROCESSORS 



CP-R famishes software wr ire-protect ion of disk files in 
addition to that furnished by the hardware write-protect 
switches. Normally, background programs ore allowed to 
write only in the Background Data area or Background Temp 
areas of the disk, foreground programs are allowed to write 
into the foreground and Background Data areas. The fere- 
ground user is responsible for ensuring that lOEX (direct I/O) 
writes only in the IOEX-Access area of the disk. The System 
Program area, Foreground program area, and Background 
Program area can be written into only if the "SY" key-in is 
in effect for the fob in which the writing task h defined. 



Similarly, the Overlay Loader and RADEDIT (background 
processors) are allowed to write in nonbackground areas 
| only if the "SY" key-in is in effect for the background job. 
Any disk write-protection violation will result in a write- 
protection error indication return, and the write order will 
not be carried out. 

All disk files can be read by a user without restriction. 
There is no system-furnished read protection for disk files. 



LANGUAGE PROCESSORS 

The following language translators are available for inclu- 
sion in the operating system: 

Extended FORTRAN IV 

SL-1 

Assembly Program (AP) 

Extended FORTRAN IV is a three-pass compiler that is a 
superset of ANS FORTRAN, incorporating many features 
not found in other FORTRANs. 

SL-1 is a simulation language to solve differential equations 
as the fundamental procedure in simulating parallel, con- 
tinuous systems. An extensive set of macros permit the user 
to simulate wide variety of linear and nonlinear elements 
through the use of single^perotor statements. These 
prototype statements are inserted into the user program 
each time a macro is referenced by name. 

Assembly Program (AP) is a three-pass assembly processor 
with a fourth pass that generates and prints a cross refer- 
ence listing. The first pass accepts input written in sym- 
bolic format, compressed format, or compressed format with 
symbolic corrections or updates. Pass 1 then produces an 
encoded program used by the other passes for further pro- 
cessing, depending on the options specified on the |AP 
control command. The first pass is required for all AP 
runs; the other three passes are optional. The final as- 
sembly pass (Pass 3) outputs the program in standard object 
language. 



Service processors provide routines for performing frequently 
used functions. The service programs include the Overlay 
Loader, RADED1T, and Edit. 



OVERLAY LOADER 

The Overlay Loader (a background processor) is used to 
create overlay-program load modules for later execution in 
either the foreground or background. Thus, if a foreground 
program con tolerate a slight delay in reading overlay seg- 
ments into memory for execution, either foreground or back- 
ground programs of virtually unlimited size can be constructed 
even though memory size is restricted. For example, a 
1400-word overlay can be input in about 50 milliseconds, 
using a Model 7204 Disk; that is, the time required to bring 
in an overlay for execution is the time of the one disk access 
required to read the overlay. Since a load module is stored 
on disk in "memory image form", it can be loaded very 
quickly as one logical record per segment. A load module 
formed by the Overlay Loader can be entered permanently 
into the System Program area, Foreground Program area, 
or Background Program Area, or it can be loaded on a tem- 
porary file in the Background Temp area of the disk. 

An overlay structure, as illustrated in Figure 1, consists of 
a permanently-resident root segmentandany number of over- 
lay segments. A blank COMMON and labeled COMMON 
data area can be established for use by the root and overlay 
segments. Each segment is created by the Loader from one 
or more object modules output by a language processor. The 
Loader will build the Program Control Block, the OVLOAD 
table (used to load the overlay segments at execution time), 
allocate or build DCBs, and allocate the temp stacks. It 
will also load library modules to satisfy unsatisfied references 
encountered in the loading process. A maximum of two 
libraries can be searched. Library search and loading are 
extremely fast, due to special tables that are added to the 
library files at the time the library b created on disk. 

The overlay segments must be explicitly defined at link- 
edit time and explicitly called at execution time. All 
segments in a path may communicate with each other via 
REF/DEF linkages, but it is the user's responsibility to en- 
sure that any segment referenced is currently in memory. 



MOEDIT 

RADEDIT controls disk allocation For areas containing per- 
manent disk files and performs utility functions for all areas. 

RADEDIT performs the following functions: 

1 . Adds or deletes entries in the permanent file directories. 

2. Compacts disk areas by relocating files and updating/ 
compacting directories to regain space within an area. 

3. Mops permanent disk file allocations. 
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Figure 1. Overlay Structure 



4. Builds and maintains library files on the disk for use by 
the Overlay Loader. 

5. Copies permanent disk files. 

6. Saves the contents of disk areas in self-reloadable form. 

7. Restores disk areas previously saved, 

8. Dumps the contents of permanent disk files or areas. 

When used from a TJE job, not all of these functions are 
available. (See Chapter 14. ) 



EDIT 



The Edit processor is a I ine-at-a-time text editor designed 
for on-line or batch creation, modification, and handling 
of programs and other bodies of information. All Edit data 
is stored on disk storage in a keyed file structure of 
sequence-numbered variable length records which is built 
and maintained only by the Edit processor. 

Between editing sessions, the data may be saved on stan- 
dard CP-R files of blocked, unblocked, or compressed 
organization and can be accessed by an/ other program or 
processor. 

Edit functions are controlled through single-line commands 
supplied by the user. The command language provides for 
insertion, deletion, reordering, and replacement of lines 
or groups of lines of text. It also provides for selective 
printing, renumbering records, and context editing oper- 
ations of matching, moving, and substituting line-by-line 
within a specified range of text lines (see Chapter 13). 



BACKGROUND JOB ORGANIZATION 

The user controls the execution of a background job by means 
of control commands. These control commands are inter- 
preted by either the Job Control Processor (JCP), Overlay 
Loader, or RADEDIT; they specify 

e Processors required and the options to be used. 

e Input/output devices required and their specific 
assignments. 

e Loading and execution requirements. 

e Libraries and supporting services required. 

e Program modification and debugging requirements. 

A batch job is a sequence of control commands that may 
be executed independently. Each such background job 
is independent of any other job and consists of one or 
more directly or indirectly related job steps. A job 
step results in the execution of a processing program 
such as a language translator, service program, or user's 
program. 

FOREGROUND JOB ORGANIZATION 

The user may define a set of one or more related foreground 
tasks as a job. Such a fob may specify that certain per- 
ipheral devices or files are private for its use, or the job 
may gain exclusive control of a device on a temporary basis. 
All tasks within a foreground job may access the device de- 
fined as private. 
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MPUT/WTPOT SPECIFCATIONS 

Throughout the CP-R system, specifications of input data 
sources and output data destinations are made by giving a 
physical device name (see Tables 1-3), a disk file identifier 
(see Table 4), or an operational label (see Table 5). 





Table 


1. I/O Device Type Codes 


YY 


Device Type 


TY 




Typewriter. 


LP 




Line printer. 


CR 




Card reader. 


CP 




Card punch. 


9T 




9-track magnetic tape. 


7T 




7-track magnetic tape. 


DC 




Fixed-head disk. 


DP 




Disk pack unit. 


PL 




Plotter. 


NO 




Not a standard device. Used as a 
special purpose device for IOEX. 


LD 




Logical device. 


LN f 




Remote Terminal. 


f lnrh 


is case the device name will be LNxxx where 


xxx represents the decimal line number. 



Table 2. Channel or Cluster/Unit Designation Codes 



Specified 
Character 
<n) 


Significance 


Sigma 9 
Unit Address 


Xerox 550 


Cluster 
Address 


Unit 
Address 


A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 



1 
2 
3 

4 
5 
6 
7 



1 
1 
1 
1 
1 
1 

2 
2 
2 
2 
2 
2 




1 
2 

3 

4 
5 

1 
2 
3 
4 
5 



Table 2. Channel or Cluster/Unit Designation 


Codes (cont. ) 


Specified 
Character 
(n) 


Significance 


Sigma 9 
Unit Address 


Xerox 550 


Cluster 


Unit 






Address 


Address 


N 


- 


3 





O 


- 


3 


1 


P 


M 


3 


2 


Q 


- 


3 


3 


R 


- 


3 


4 


S 


- 


3 


5 


T 


- 







U 


- 




1 


V 


- 




2 


W 


- 




3 


X 


- 




4 


Y 


- 




5 


Z 


- 


5 








- 


5 


1 


1 


- 


5 


2 


2 


- 


5 


3 


3 


- 


5 


4 


4 


- 


5 


5 


5 


- 


6 





6 


- 


6 


1 


7 


- 


6 


2 


8 


- 


6 


3 


9 


- 


6 


4 


blank 


- 


6 


5 


$ 


- 





1 


# 


- 





2 


@ 


- 





3 


: 


- 





4 



Table 3. Device Designation Codes 



Hexadecimal 
Code (dd) 


41 

Device ■* 
Designation 


00<dd<7F 
(single devices) 

eOSddSFF 
(multiple devices) 


Refers to a device number 
(00 through 7F). 

Refers to a device controller num- 
ber (8 through F) followed by a 
device number (0 through F). 
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Table 4. Disk Area Codes 



Code 


Area 


SP 


System Program area. 




FP 


Foreground Program area. 




BP 


Background Program area. 




BT 


Background Temp area. 




XA 


IOEX Access area. 




CK 


Checkpoint area. 




Dl ' 








DA 




Data area (number of data areas 
defined at SYSGEN). 


is 


DF . 









PHYSICAL DEVICE NAMES 

Physical device names are of the form 
hdd" 



Wxxx]j 



where 

yy identifies the type of device (see Table 1). 

n identifies the channel or cluster/unit number (see 
Table 2). 

dd identifies the device number (see Table 3). 



See Command Syntax Notation for significance of brackets. 





Table 


5. System Operational Lab 


els 




Label 


Standard or 
Optional 


Reference 


Comments 


BI 


Standard 


Binary input 


Used to input binary information. 




BO 


Standard 


Binary output 


Used by processors to output binary 
information. 




C 


Standard 


Control command 
input 


Used by the system and processors to 
read control commands. 




CI 


Standard 


Compressed input 


Used by AP. 




CO 


Standard 


Compressed output 


Used by AP. 




DI 


Optional 


Debug input 


Used by the Debug facility. 




DL 


Optional 


Debug listing 


Used by the Debug facility. 




DO 


Standard 


Diagnostic output 


Used by the system for postmortem 
dump and diagnostic messages and by 
AP for diagnostic messages. 




DP 


Optional 


Debug patch 


Used by the Debug facility. 




ER 


Optional 


Error logging 


Used by Error Logger. 




LL 


Standard 


Listing log 


Used by the system and AP to log 
control commonds and other system 
messages. 
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Table 5. System Operational Labels (cent. ) 



Label 


Standard or 

Optional 


Reference 


Comments 


LO 


Standard 


Listing output 


Used for object listings from assemblies 
and compilations. 


MO 


Optional 


Medio output 


Used by Medio facility. 


OC 


Standard 


Operator's console 


Used by the system for key-ins ond op- 
erator control. (Always assigned to a 
keyboard/printer. ) 


PI 


Optional 


Debug utility 1 


Used by the Debug facility. 


P2 


Optional 


Debug utility 2 


Used by the Debug facility. 


5E 


Optionol 


Save environment 


Used by Alarm Saver. 


SI 


Standard 


Symbolic input 


Used by processors to input source 
(symbolic information). 


SO 


Standard 


Symbolic output 


Used by SL-1 ond AP. 



xxx identifies the line number of a communication 
line. 



and 



identifies the null device. 



The null device does not exist as such, but may be used 
whenever a device of the form yyndd is valid. Input and 
output requests to the null device cause a normal type com- 
pletion and zero actual record size to be posted. No data 
is moved to or from the I O buffer. 

Note that a physical device name may be the name of a 
logical device (LDndd). 



DISK FILE DENT1FIERS 

Disk file identifiers hove two basic forms: 

I . area, name 

where 

areo is the name of any disk area defined on 
the system. 

name is the name of the file. 



This form of file identifier may occur only in o paren- 
thesized group, for example, as in the background 
command: 

LOAD (OUT,SP,RADEDIT) 

or the keyin : 

BATCH (Dl, J OB FILE) 

Files in accounts other than the system account may not 
be identified in this form. 

2. [name] [. [area]][. [account] ] 

where 

name is the name of the file. If omitted, the 
area must be specified, and the whole area is 
the identified medium. 

area is the name of the disk area irrVhich the 
file resides, and may be any area defined on 
the system. If omitted, the file is assumed to 
reside in a public area and the area will be 
determined by the system. 

account is the name of the account in which 
the file is defined. Account names must have 
at least one character, and at most, eight. 
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The account name may be omitted, in which 
case, a default is provided. If the area name 
it alto omitted, the account name defaults to 
that in which the task which opens the file is 
running. If the area name is specified, the 
account name defaults to the system account. 

Files of the tame name may be defined as long as they 
differ in either account name or area name, however, 
if files of the same name and account are defined in 
different public areas, one of them will be inaccessible 
except by explicit specification of its area name, since 
by default, the one found first is accessed. 

The Background Temp area (BT), is a special area in that its 
file names are restricted to the set, GO, OV, and XI 
through X9 and account name is not required, its primary 
purpose is for work files for the background processors. Its 
files are temporary and will be d bearded at the beginning 
of the next job. 

Files in other areas ore permanent files and will be kept 
by the system until they are explicitly deleted. 



OPERATIONAL LABELS 

Operational labels (oplabels) are names used to symbolic- 
ally reference physical devices and disk files. All oplabels 
are defined ot SYSGEN (see Chapter 15) and are given 
their permanent default, or system initialization assign- 
ments. System oplabels, as listed in Table 5, are treated 
specially: 

First, they are created automatically during SYSGEN. The 
Standard System Operational Labels are always created in 
all SYSGENS. The optional system operational labels are 
used by optional features in the CP-R operating system and 
are created only if their associated feature is included in 
the system. Any user desired op label must be defined in 
SYSGEN. Default oplabel assignments are also made in 
SYSGEN. 

Second, they are used by the CP-R system and its processors 
as the standard assignments for standard DCBs. For ex- 
ample, processors producing binary output do so to the 
M:BO DCB, and unless explicitly changed, the DCB is 
assigned to the BO oplabel. Where the output actually 
goes is a function of the assignment of the BO oplabel. 



Opkbels are considered job level resources. That is, each 
fob wfrhin the system has its own separate set of oplabel 
assignments. The oplabel assignments for the CP-R job are 
used as the default assignments for other jobs. When a new 
job is activated, this set of default assignments becomes the 
Initial assignments in >be new job. Any reassignment* in 
that new job affect only that job. The assignments are 
retained until changed or the job terminates. 

The default assignments in the CP-R job may be changed 
(see STDLB key-in). The resultant set of assignments be- 
comes the default set for any subsequently activated jobs. 



RESOLVING I/O MEDIUM NAME AMBIGUITIES 

When a command permits more than one I/O medium type to 
be named in the same field, certain ambiguities may arise 
as to which type of name is intended; for instance, '9TA80' 
could be either a file name or a device name. The follow- 
ing rules resolve this type of ambiguity: 

). Names preceded or followed by periods are parts of file 
identifiers. This means '.SI' is not an operational label, 
and '9TA80. ' is not a device. 

2. Names followed but not preceded by periods are file 
names, for example, '9TA80. ' is a file name, not a 
device. 'SI. ' is also a file name, not a disk area name 
or an operational label. 

3. A name is a disk area name if it follows a period, it does 
not follow another area name in the same file identifier, 
it has two characters, and it is defined as an area name 
in the system. 

4. A name is a disk file account name if it follows a period 
and is not selected by rule 3. 

5. A name is an operational label if and only if it has two 
characters, it is defined as an operational label in the 
system, and it is not excluded by rule 1. 

6. A name is a device name if and only if it has five char- 
acters, it is defined as a device in the system, and it is 
not excluded by rule 1. 

7. Names which are not typed by rules 1-6 are tested first 
as area names in file ID format 1, then as file names 
(with unspecified area and account) in file ID format 2. 
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2. CONTROL COMMANDS 



Background processing is controlled and directed by mean; 
of control commands. These commands effect the construc- 
tion and execution of programs and provide communication 
between a program and its environment. The environment 
includes CP-R and the assembly language processors, com- 
piler language processors, service processors, the operator, 
and the peripheral equipment. 



Control commands have the general form 

A 



Imnemonic specification 



where 

I is the first character of the record and identifies 
the beginning of a control message. 

mnemonic is the mnemonic code name of a control 
function or the name of a processor. The name, 
consisting of up to 8 characters, may begin any 
number of spaces after the I character, except for 
an EOD command. 

specification is a listing of required or optional 
specifications. This may include keywords, con- 
sisting of up to 8 characters, labels, and numeric 
values appropriate to the specific command. 

For illustrative purposes within this manual only, the op- 
tions of the specification field may be shown enclosed by 
brackets, braces, and/or parentheses. In actuality, only 
parentheses may be used. Parentheses ore mandatory only 
when an option has two or more sub fie Ids (see Command 
Syntax Notation). 

One or more blanks must separate the mnemonic andspecifi- 
cation fields, but no blanks can be embedded within afield. 
A control command is terminated by the first blank after the 
specification field, or, if the specification field is absent 
and a comment follows the command, the command is termi- 
nated by a period after theblankthat follows the mnemonic 
field. Annotational comments detailing the specific pur- 
pose of a command may be written fol lowing the command 
terminator, but no control command record can contain more 
than 80 characters. 



A control command can be continued from one record to the 
next by using a semicolon to replace the comma as a sub- 
field terminator in the specification field of the command. 
Column one of the continuation card must contain either on 
exclamation mark (if the control command is to be read by 
the Job Control Processor), or a colon (if the command is to 
be reod by the Overlay Loader or RADEDIT). See the con- 
trol command examples given later in this chapter for an 
illustration of the proper use of the semicolon. 



Control commands are usually input to the monitor via 
punched cards; however, any input device(s) may be de- 
signated for this function. All control commands are listed 
on the output device designated as the listing log (normally 
a line printer). In this manner, the monitor keeps a record 
of the progress of the background. When a job is aborted, 
all control commands skipped over until the next JOB com- 
mand is encountered ore listed on LL with a "greater than" 
character (>) in column one. 

Note that in all control commands, excluding processor 
control commands, the first three characters after the 
I character are sufficient to define any mnemonic code 
or keyword. 



Control commands may be 
System Control 



categorized as follows: 
Debug Control 



JOB 


PMD 


ASSIGN 




LOAD 


Utility Control 


ATTEND 




MESSAGE 


PFIL 


PAUSE 


PREC 


CC 


SFIL 


LIMIT 


REWIND 


STDLB 


UNLOAD 


ROV 


WEOF 


RUN 


DAL 


ALLOBT 




MODIFY (special) 


Processor Control 


LIST 




INIT 


Processor name 


SJOB 




BATCH 




Input Control 





EOD 
FIN 



JOB CONTROL PROCESSOR 

All control commands are read from the "C" (oplabel) 
device by the Job Control Processor (JCP). The JCP is 
a special processor loaded into the background by CP-R 
upon the initial "C" key-in. The JCP is also reloaded 
into the background following each job step wTrhin a job. 
A job step is defined as all control commands required 
for the set-up and execution of a single processor or user 
program within a job stack. 

The JCP processes each control command until a request is 
made to execute a processor or user program, at which time 
the appropriate program is read into the background and 
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given control. A detailed description of the JCP interface 
with the system processors or user programs is given later in 
this chapter under "Processor Control Commands". 



SYSTEM CONTROL COMMANDS 

JOB _ Each background job to be processed by the system 
must begin with a JOB control command. The JOB command 
signals the completion of the previous job, if any, and the 
beginning of a new one. The JOB command causes the tem- 
porary assignments of all operational labels (except the "C" 
operational label) to be reset to their permanent assignments. 



(DCB) in the next background program or processor to be 
loaded. ASSIGN commands must appear prior to the RUN 
or Processor name command to which it will apply. They 
are effective for that job step only. 

The assignment can be to a physical de'ice, a disk file, or 
anoperational label. If an error is detected in the command, 
the entire command is rejected and must be input again. 

The form of the ASSIGN control command is 



(ASSIGN (deb, 



fid "J 
device l)[, (opt 
oplabel J 



ion),...] 



The form of the JOB command is 

A 



[JOB [account number, name [, priority]] 



where 



account number identifies the account or project. 
It consists of from 1 to 8 alphanumeric characters. 

name identifies the user. It consists of from 1 to 
12 characters. 

priority specifies the priority of the job and deter- 
mines the order in which jobs are run in a symbiont 
system. Legal values are: 

hold in job queue until priority is changed 
by a PRIORITY key-in. 

1-7 lowest to highest priority. The default 
value is 1. 



Note that commas separate the optional subfields. The 
account number must precede the name, and both fields 
must be present if either one is present. If the priority is 
present, the number and name fields must be present. The 
account and name information are verified against the infor- 
mation in the A] file and if not valid the job is aborted. 

Example: 



r 



IJOB 12345,JOBSAMPl 



The above example defines the account number for the job 
as 12345, and the user as JOBSAMP1. The job will have 
priority 1, by default. 



ASSIGN The ASSIGN control command allows the 

changing of the default assignment of a Data Control Block 



where 

deb is the name (not exceeding eight characters in 
length) of the DCB to be assigned. It must be the 
first subfield following ASSIGN and must be fol- 
lowed by a specification (see below). The first two 
characters of a user's DCB must be "F:" (e.g., 
F:PRINT or F:BI). The first two characters of a 
system DCB name are "M:" (see Table 12). 

fid is the CP-R file identifier for a file to which the 
DCB is to be assigned. File identifier format is 
defined in Chapter 1. 

device specifies a physical device name or a nu- 
meric zero, "0", the null device. 

oplabel specifies one of the operational labels 
defined during SYS GEN (see Table 5). 

The options below are used only if the user creates the DCB 
or changes some of the DCB's parameters. Note that DCB 
parameters not specified on the ASSIGN command are not 
changed from their initial value. The initial values of the 
DCB parameters depend upon how the DCB wot created. 

Parameters of system DCBs have standard default values. DCBs 
allocated by the Overlay Loader (F:DCBt) ore set to all zeros. 
User created DCBshavethe in itio I values specified by the user. 



Mode (may be any or all of the following): 



BCD] specifies the EBCDIC or automatic 

1 device mode. 

BIN ) specifies the binary device mode. 

VFC specifies vertical fognat control. 

NOVFCj specifies no vertical format control. 

PACK 1 specifies that the packed binary or 

unpacked binary mode is to be 

UNPACKJ used for 7-track magnetic tope. 

PACK and UNPACK are not 
valid unless BIN is specified. 
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D1600 
D800 

Ascn 

EBCDIC 

ORC 

NODRC 



specifics density for tape drives with 
program-control Idble density 
(1600bpSor800bpi). 

specifies tape data code for tape drives 
with program-controllable data 
encoding. 

specifies whether transfers with a 
keyboard-printer are to be in 
direct record control mode (no 
editing) or not. 



3. Assign source input to a disk file in the D 1 data area: 



Number of recovery tries 

TRIES, value specifies the maximum number of re- 
covery tries to be attempted for an I/O operation. 
The value must be less than 256. 



r 



I ASSIGN (M:Sl,PRESTORE.Dl) 



This example assigns the M:SI DCB to the disk file 
FRESTORE, which is in the Dl orea. This type of as- 
signment could be used to assemble a source program 
that had been prestored onto a disk file. 



4. Build a user DCB that was left empty ot load time; 
JASSIGN (F;XX,7TAE0),PACK,(TRIES,3), 



(RECL,80),BIN 



Default record length 

RECL, value specifies the default record length in 
bytes. The value n must be l<n<32,767. This 
record length is used for all requests referencing 
the DCBs that do not explicitly specify a record 
length in the FPT. 



Byte displacement of first byte in buffer 

BTD, n specifies the byte displacement of the first 
byte of the buffer. The value n is subject to the 
limits S n £ 3. This value is the byte at which 
the buffer begins within the word specified as the 
buffer word address. Thisbyte displacement is used 
for all requests referencing the DCB which do not 
have BTD parameters in their FPTS. 



Examples: 

1. Assign listable output to a magnetic tape: 

lASSIGN (M:LO,9TA81),VFC 



This example assigns the M:LO DCB to a 9-track mag- 
netic tape. Vertical format control is also specified, 
so the first byte in each record is a format control byte 
for the line printer. 

2. Assign binary output to the GO file: 



r 



(ASSIGN (M:BO,BT,GO) 



This example builds a user DCB, F;XX, and also assigns 
F:XX to a 7-track mognetic tape. The packed binary 
mode (PACK) will be used in accessing the tape, and 
a maximum of three recovery tries (TRIES, 3) will be 
attempted for a possible tape parity error. The de- 
fault record size to be reod or written is 80 bytes 
(RECL, 80). 



5. Assign a user DCB to read nonstandard binary cards; 



(' 



lASSIGN (F:INP,CRA03),BIN 



This example assigns the user DCB, F:INP, to the card 
reader, and specifies that the binary mode is to be used 
in reading the cards. This type of assignment would be 
used to change an existing DCB to read nonstandard 
binary cards. 



6. Assign a user DCB to a public file in the user's own 
account: 



r 



lASSIGN (F:FILE, FILENAME) 



This example assigns the DCB named 'F:FILE' to a file 
named 'FILENAME' in the user's account, in whichever 
public disk area it is found. 



7. Assign a system DCB to a file in a speciiied account 
and area: 



' 



lASSIGN (M:BI, ROM. D4. MYACCNT) 



This example assigns the M:BO DCB to the GO file. 



This example assigns the M:B1 DCB to o file named 
•ROM' in account 'MYACCNT' in area D4. 
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LOAD The LOAD control command directs the JCP 

Loader to load a background program on the disk and ab- 
solutize it for its main memory execution location. 



The form of the LOAD command is 



(' 



ILOAD [(oprion),(option)] 



where the options are 

| lN,fid/nome specifies the input device as a system 

physical device name, a system operational label, 
or a disk file from which the object modules will 
be loaded. The default input device b the one 
assigned to the BI operational label. 



OUT,fid/name specifies the output device as an 
operational label or a disk file on which the 
loaded program is written. The default output de- 
vice is the OVfile. 

EXLOC,value specifies the execution location (in 
hexadecimal) of the program being loaded. The 
default location will be the start of background. 

SEG,value specifies the decimal number of overlay 
segments that follow the root. The default value 
is zero, which means only a root is being loaded. 

MAP specifies that a map of the loaded program be 
output to the LO device. The default is no map. 



The primary function of the JCP Loader is to load the Over- 
| lay Loader at SYSGEN time. However, the JCP Loader 
will load any nonoverlaid background program or one with 
a simple tree structure under certain restrictions (see 
Appendix E). 



Example: 

Load Overlay Loader from cards: 



ILOAD (IN,CRA03),(OUT,SP,OLOAD),- 



-(SEG,6),MAP 



This command would be used to load the Overlay Loader 
onto its permanent file (OLOAD) in the SP area of the 
disk. Six overlay segments (SEG, 6) are specified and 
a MAP of the load is requested. The complete deck 
structure required to perform the load is illustrated in 
Figure 2. 



ATTEND The ATTEND control command is used during 

a programmer-attended run and indicates that CP-R is to go 
into a WAIT condition after a WAIT system call or after an 
abort from the background. After an unsolicited key-in 
of "C", background processing will continue from the point 
of the wait. If the ATTEND control command is not speci- 
fied and an abort or error condition occurs, or if a WAIT 
system call is made, the system does not pause for operator 
intervention but skips all control commands, binary records, 
and data until a JOB or FIN command is encountered. When 
in skipping mode, alt control commands encountered wi 1 1 be 
listed on the LL device, with a greater than character (>) re- 
placing the exclamation mark in column 1. Thedefault mode 
of operation (no ATTE ND command present) is used for closed- 
shop batch processing and there are no halts between jobs 
after an abort. 



The form of the ATTEND command is 



(' 



IATTEND 



The effect of on ATTEND command exists for one job only. 
Normally, the ATTEND command immediately follows the 
JOB command. 



MESSAGE The MESSAGE control command is used to 

type a message to the operator. The message will be typed 
on the OC device and normal processing will continue after 
the message is output. 



The form of the MESSAGE command is 



(MESSAGE message 



where message is any comment to the operator, up to a full 
card image (80 columns). The message may contain any de- 
sired characters, including blanks, but may not be con- 
tinued from one record to the next. Two ormore MESSAGE 
control commands may be used in immediate succession. 

Note that the entire card image, including IMESSAGE, 
will be output to LL and OC. 

Example: 

/(MESSAGE SEND ALL SAVE TAPES TO JOHN SMITH 



The above example would cause the following message to 
be output on the LL and OC devices: 

I IMESSAGE SEND ALL SAVE TAPES TO JOHN SMITH 

Note: All CP-R messages to the operator begin with two 
exclamation characters. 
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IEOD 



| IF IN 



| IEOD 



I Binary Deck of Overlay 6 



Binary Decks of Overlays 3-5; each deck 
. followed by an IEOD 



^ 



Z. 



£ 



Binary Deck of Overlay 2 



^ 



IEOD 



Binary Deck of Overlay 1 




IEOD 



£ 



Binary Deck of Overlay Loader Root 



<> 



l(OUT,SP,OLOAD),(SEG,6),MAP 



JLOAD(IN,CRA03); 



I PAUSE KEY-IN 'SYC 



IJOB 



y 



y 



y 



Figure 2. Loading Overlay Loader from Cards 



LIST The LIST command is identical to the MESSAGE 
command above, except that the message is listed on LL 
only, and not on LL and OC. 



The form of the LIST command a 



ILIST message 



where message may be any comment up to a full card image 
of 80 columns. 



PAUSE The PAUSE control command is similar to the 
MESSAGE command except that the JCP will enter a sus- 
pended state after the message is output to OC to give the 
operator time to carry out the instructions in the message. 
Processing is continued after an unsolicited key-in of "C". 

The form of the PAUSE command is * 



r 



I PAUSE message 



where message is any comment to the operator, up to a full 
card image (80 columns). PAUSE does not require ATTEND 
mode. 
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Example: 



The fonn of the STDLB command is 



r 



IPAUSE KEYIN SYC 



The above example would cause the monitor to pause ex- 
ecution with the following message output on LL and OC, 

I IPAUSE KEYIN SYC 

giving the operator time to key in SYC, which would per- 
mit the user to override the write protection on the disk 
and continue the background job. 



CC The CC control command removes typewriter over- 

ride of the C device (see TY key-in description). The next 
control command will be read from the C device instead 
of the typewriter. 

The form of the CC control command is 



ICC 



The CC control command has the same effect as the CC 
key-in, and can be used whenever the JCP has control. 



LIMIT The LIMIT control command is used to set a maxi- 
mum allowable execution time and maximum allowable 
number of line printer pages for a background program. If 
the job exceeds either limit, the background is aborted with 
a postmortem dump (if the dump opt ten was specified via a 
PMD control command). 

The form of the LIMIT control command is 



ISTDLB (label, 



ffid 
device 
op label 



1), (label, device )...] 
J L [oplabel j J 



where 



label specifies the operational label to be assigned. 
It must have been defined during SYSGEN (see 
Table 5). 

fid specifies the identity of a file, in the format 
defined in Chapter 1. 

A disk file Xn in the BT area must have been de- 
fined by the JCP prior to its use in this command. 
(See the ALLOBT command. ) 

device specifies a physical device name or a 
numeric zero, "0", the null device. 

oplabel specifies another operational label is to 
be used. "Label" will receive the same assign- 
ment as "oplabel" has currently. 

Notes: 1. The C oplabel cannot be assigned to the nul I 
device. 

2. If an error is detected, al I assignments pre- 
ceding the one in error will have been made. 

Example: 

Change temporary assignments of operational labels: 



(' 



ISTDLB (BO,BT,GO),(CO,COMPRESS. D2),(LO,9TA80) 



This example could be used for an assembly to change the 
binary output to the GO file, the compressed output to the 
COMPRESS file in the D2 area of the disk, and the Irsrable 
output to a 9-track magnetic tape. 



r 



IUMITn[,m] 



where n specifies the maximum allowable execution time 
in minutes and m specifies the maximum allowable number of 
line printer pages. 



STDLB The STDLB command is used to change the as- 

signment of an operational label (with the exception of the 
OC —Operator's Console) for the current background job. 
The operational labels being changed receive the new 
assignments, which stay in effect until the next JOB com- 
mand is encountered. 



ROV The ROV command (RUN OV) causes execution 

of the program (either foreground or background) on the 
OV file. 

The form of the ROV command is 



yiROV 



Only primary programs may be loaded into Foreground with 
this command. The loading of any program into the fore- 
ground area via an ROV control command must be preceded 
by an FG key-in (see Chapter 3). A foreground program 
loaded by I ROV 1* given the name OV and runs under the 
CP-R job. There may be only one such program resident at 
any time. 



System Control Commands 17 



If a priority other than the default value of X*7F (as defined 
under the RUN control command) is to be associated with 
the foreground program, the (RUN BT, OV, priority com- 
mand should be used. The default value X'7F' is the lowest 
priority. 



RUN The RUN control command causes the named fore- 

ground or background program to be executed. 

The form of the RUN command is 



r 



where 



IRUN fid [,priority][, DEBUG] 



fid specifies the identity of the load module to be 
executed. The loading of any program into the 
foreground area via a RUN control command must 
be preceded by an FG key-in and must be a pri- 
mary program. It will run in the CP-R fob. 

priority is a hexadecimal number in the range 
through X'7F', to be assigned to the foreground 
RUN request if the memory space is currently 
being used by another foreground program. The 
lowest priority, X'7F', is the default value. 

DEBUG specifies that the program is to nm under 
the control of the CP-R Debug facility. 



WIT The I NIT control command causes the named 

foreground task to be read into memory and initiated. The 
INIT command has the form 



UNIT taskname [, (JOB, jobname)] [,PRI][, STOP] 



C 



Z2 



[,(PRIO,xxxx)][.DEBUG][,TS] 



PRI Identifies the task as a primary task. If the 
PR] option is not specified, the task is run as a 
secondary task. 

STOP specifies tliat the task is to be left in sus- 
pended state after bad. The default is to exe- 
cute directly after load. This option is invalid 
for a primary task. 

PRIO is a keyword indicating that task priority is 
specified. This option is valid for secondary tasks 
only. The default is to run under the lowest-priority 
dispatcher, at the lowest software priority. 

xxxx is the hexadecimal priority value for the task. 
The first two characters specify the interrupt level, 
minus X'4F', of the dispatcher for the task. The 
last two characters specify the software priority 
for the task. 

DEBUG indicates that the task is to be initiated 
under control of Debug. 

TS indicates that the task is to be time-sliced. 



Note: UNIT command may not be used to start a back- 
ground program. 



SJOB The SJOB control command creates a foreground 

job. It sets up job controls and table entries but does not 
initiate any task in the job. The SJOB command has the 

form 



r 



where 



ISJOB jobname [, (DEBUG,TYndd)][, (ACCT,xxx)] 



jobname is the name of the job to be started. 



where 



taskname is the file identifier for the Load Module, 
with the exception that the specified file name may 
be converted to an actual file name by lookup in 
the Job Program Table. If no match is found in the 
JPT, the specified file name is used. 

JOB is a keyword and indicates that the task is to 
be run under a job other than the CP-R job. If the 
JOB option is not specified, the task will be run 
under the CP-R job. 



jobname specifies the name of the job under which, 
the task is to be run. It may not be "BKG". 



DEBUG indicates that a Debug control -console de- 
vice address is specified. 



TYndd Is the address that Debug will use for com- 
munication with the user when any task in the 
job is given control under Debug. 



ACCT indicates that on account number (xxx) is 
being supplied. 



xxx The account number the named JOB is to be 
associated with. 
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BATCH The BATCH commend allows a background job 
to cause o file to be entered in the background stream as a 
control deck for a later job. This commend is available 
only in systems generated for symbiont-supported background. 

The form of the batch command is 



I BATCH fid 



where 



fid 



is the identifier for the file to be entered into 
the batch stream. File identifier format is defined 
in Chapter 1. A batch file may contain only one 
background job. 



ALLOBT The ALLOBT control command is used to de- 

fine the files in the BT area of the disk, and overrides any 
JCP default definitions. The Tiles input on the ALLOBT 
command will receive the specified sizes and formats. The 
Piles defined via an ALLOBT command will stay in effect 
only for the current job step unless the SAVE option is 
invoked. If the SAVE option is used, the ALLOBT com- 
mand will stay in effect for the entire job (any input for 
the GO or OV files will always stay in effect for the entire 
job). 

The form of the ALLOBT command is 

,/lALLOBT (FILE,nn)[,(option),(option). . .] 



where 

FILE, nn specifies the name of the background temp 
file to be allocated. Legal names for nn are 
Xl,X2,...,X9,GO or OV. 

The options are 

FORMAT, value specifies the format of the file; 
U for unblocked, B for blocked, C for compressed. 



RSIZE, value specif ies the decimal number of words 
per logical record. This field is only meaningful 
for blocked or unblocked files since the monitor 
compresses records of compressed files into 256- 
word blocks. Blocked files have a default record 
size of 128 words, and unblocked files have a de- 
fault record size equal to the granule size. Note 
that if RSIZE > 128, unblocked organization will 
always be given to the file. 

GSIZE, value specifies the decimal number of words 
per granule. This field is only used in directly 
accessing a file. The default granule sizewill be 
the size of a disk sector. 

SAVE specifies that this file is to be saved through- 
out the job and not real located between job steps. 

Example: 

Change the default assignments of the background temp 
files: 

The group of ALLOBT commands 



! ALLOBT (FIL,OV),(FSIZ,0) 



4 |!ALLOB(FIL,X4),(FSI,ALlT 
ll(GSIZE,180) 



IALLO(FILE,X3),(FSIZE,20); 



-|l(FSIZE, 100), (RSIZE, 30) 



2 |!ALL (FILE,X2), (FORMAT, B); 
|l(FSIZE, 1000), SAVE 



IALLOBT (FILE,Xl),(FORMAT,C); 



The default is unblocked for all files except GO; 
the default for GO is blocked. 

FSIZE, value specifies the decimal length of the 
file in logical records. If ALL is input for a value, 
the remainder of the BT area will be allocated 
for this file. An ALL input is allowed only once 
and is only allowed for Xi files (not GO or OV). 
A check is made for overflow of the BT area at 
the time the ALLOBT command is input. The de- 
fault value is 1000 records. Note that the file 
size in sectors is computed using the logical 
record size and not the granule size. 



could be used by a background program to achieve the 
following results: 

1. The XI temp file would be a compressed file that could 
hold approximately 1000 EBCDIC eHrds. This file 
would be saved throughout the entire job. 

2. The X2 temp file would be a blocked file that could 
hold a maximum of 100 binary cards. 

3. The X3 temp file would be an unblocked file contain- 
ing 40 sectors (assuming a 7204 disk) with a granule 
size of 180 words or two sectors. 
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4. The X4 temp file would be an unblocked fiU with a 
record and granule size of 90 words (assuming a 7204 
disk) and would be allocated the remainder of the 
Background Temp area. 

5. The OV file would not be allocated. 

After inputting this series of ALLOBT commands, the back- 
ground temp area would have the following layout (assum- 
ing a 7204 disk): 



X2 



X3 



X4 



XI 



GO 



36 Sectors 40Seetors n Sectors 120Sectors Default Size 

Note that X4 receives n sectors, where n is the remainder 
of the area after all other files have been allocated. XI is 
allocated at the opposite end of the BTarea since it will be 
saved throughout the entire job. 

The formula used to calculate the number of sectors for X2 is 



RS1ZE 
256 



x FSIZE x 3 



where 256 is the number of words per blocking buffer and 
3 is the number of sectors (assuming a 7204 disk) necessary 
to contain a blocking buffer. 

The formula used to calculate the number of sectors for XI is 
FSIZE 



25 



x 3 



where it is assumed that 25 cards can be compressed into a 
256-word blocking buffer. The number 3 is the number of 
sectors necessary to contain a blocking buffer. 



T specifies (when It precedes address ranges) that 
the dump wilt be listed in both hexadecimal and 
text for all address ranges that follow, tf the 
general T is absent, the [,(from,to,T)] option will 
dump that address range in hexadecimal ard 
text, and the [, (from, to)] option will dump the 
address range in hexadecimal only. 

from specifies the location (in hexadecimal) at 
which dumping is to begin. If no locations are 
specified, the entire background is dumped. 

to specifies the last location (in hexadecimal) to be 
dumped. The last location must £ first location. 

A maximum of four location pairs is processed and only the 
last PMD command is honored within a job step. If an error 
occurs anywhere on the command, the entire command must 
be reentered. 



Example: 

Request a postmortem dump: 



(' 



IPMD U,(I200,1300),(2000,3000,T) 



This example requests an unconditional dump at the termina- 
tion of the next program to run in the background. Loca- 
tions I200]6 through 1300] o will be dumped in thestandard 
hexadecimal format, and 2000 ] through 3000j o will be 
dumped in both hexadecimal and text. The output will be 
on the DO device. 



DUMP CONTROL COMMAND 

PHD The postmortem dump (PMD) control command 

causes the system to dump a specified area of memory if 
a background job is aborted during execution. Such a 
dump is termed "postmortem" because it is performed after 
the background program has been aborted, terminated nor- 
mally, or not executed at all for any reason. The dump is 
always output on the DO device. In the case of an abort 
the time to perform the dump is not included in the total 
time on the LIMIT control card. Note that the PMD com- 
mand must precede the RUN command. 

The form of the PMD command is 

/iPMDtLODTjCtfrom/cCjjaG/from^oGTj)]. . . 



where 



U specifies that an unconditional dump at the end 
of the job is to be output even if there were no 
errors. If U is absent, the dump occurs only if 
the job is aborted. 



INPUT CONTROL COMMANDS 

EOD The user may define blocks in a data deck by in- 

serting EOD control commands at the end of each block. 
When an EOD command is encountered, the system returns 
on EOD status. Any number of EOD commands may be used 
in a job and for any reason. 

The form of the EOD co mmand is 

/lEOD 



Note that EOD control commands must not hovAmy spaces 
between the exclamation character and the mnemonic. 



FIN the FIN control command is used to specify the end 
of a stack of jobs. When the FIN command is encountered, 
the system writes it en the listing log to inform the oper- 
ator that all current jobs hove been completed, types 
"BEGIN IDLE" on OC, and then enters the idle state. 
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All time preceding the FIN command is charged to the 
previous job, If fob accounting b being performed. All 
time from the FIN command Id the next JOB command is 
| not charged. 

The form of the FI N command is 



/|FIN 



2. Position a magnetic tape: 



IPREC BO,30 



ISTDLB (BO,7TAE0) 



This example would position magnetic tape on 7TAE0 
30 records forward from its current position. 



UTILITY CONTROL COMMANDS 

The utility control commands described below allow the 
user to manipulate magnetic tape files. 

PFILiPREC The file and record positioning commands are 
used to position a device within its current file. The PFIL 
command, will leave the device positioned before the file 
mark when moving in the forward direction and at the first 
record of the fi le when positioning backwards. For the PREC 
command, no adjustment is made when an EOT, BOT, or 
EOF mark is encountered. Only background devices (not 
dedicated to the foreground or IOEX) can be positioned. 

The forms for the PFIL and PREC control commands are 



ilPREcl """•[,-**«][,"] 



SFIL. The skip file command is used to skip one or more 
files on a magnetic tape unit. The SFIL command leaves 
the device positioned beyond the specified EOF in the di- 
rection of the tape movement. If a BOT condition occurs, 
the device is positioned at the first record following the 
BOT marker. 

The form of the SFIL control command is 

/iSFIL name[,BACK][,n] 



where 



where 



name specifies a system device name or operational 
label of the device that is to be positioned. This 
must be the first item in the specification field. 

BACK specifies that the direction of the positioning 
is backward. The default is forward. 

n specifies the number of files to skip. The default 
is one file. 



name specifies a system device name or operational 
label of the device that is to be positioned. This 
must be the first item in the specification field. 

BACK specifies that the direction of the position- 
ing is backward. The default is forward. 

n specifies the number of records to skip. The n pa- 
rameter applies only to the PREC command and 
not to PFIL. The default is skip one record. The 
PFIL command always refers to one file. (Any 
BOT, EOT, EOF marks encountered will termi- 
nate the PREC command. ) 

Examples: 

1. Position the BO oplabel to the end of the data: 

/iPFIL BO 



This example could be used to position the BO oplabel 
file so additional object modules could be added to 
those already existing. 



Example: 

Skip tape files: 



r 



ISFIL 9TA82,BACK,4 



This example would cause back skipping of four files on 
the designated 9-track magnetic tape. 



REWIND The REWIND command is used to rewind a mag- 

netic tape. It has no effect on other devices. 



The form of the REWIND command is ** 
/(REWIND name 



where name specifies a system device name or operational 
label of the device that is to be rewound. 



Utility Control Commands 21 



Example: 
Rewind a tope 



(' 



IRE WIND 7TAE0 



This example would rewind the designated 7-track tape. 



UNLOAD The rewind manual (UNLOAD) command 

causes the specified magnetic tape to be rewound in man- 
ual mode. Operator intervention will be required to use 
the device again (i.e., depressing the START switch on a 
tape drive). 



The form of the UNLOAD command is 



r 



(UNLOAD name 



where name specifies a system device name or operational 
label of the device that is to be rewound in manual mode. 



Example: 

Unload a magnetic tape: 



r 



1UNLOAD 9TA83 



This example would cause the designated 9-track tape to be 
rewound in manual mode. 



■EOF The write end-of-file (WE OF ) command causes 

an end-of-file mark to be written on the output device 
if on EOF is appropriate for the device. For magnetic 
tape, a tape mark is written; for cards, anEODis written. 
The WE OF command is ignored for all other devices. 



The form of the WE OF command is 

A 



IWEOF name[,n] 



where 



name specifies a system device name or oper- 
ational label of the device that is to receive 
the EOF. 



n specifies the number of end-of-files to write. 
The default is one. 



Example: 

Write end-of-file on magnetic tape; 



r 



IWEOF 9TA81,2 



This example would write two EOFs on the designated 
9-track magnetic tape. 



DAL The Dump Accounting Log command causes the 

contents of the Accounting Log to be printed on the LO 
device. The Accounting Log is kept on the AL file on 
the Dl area of the disk. An option exists to purge the 
fi le after the dump is completed. Note that on SY key-in 
is required to purge the AL file. 



The form of the DAL command is 
/iDAL [PAL] 



where PAL specifies that the Accounting Log is to be purged 
after the dump is completed. 



PROCESSOR CONTROL COMMANDS 

A processor control command indicates to the system that 
control is to be transferred to the specified processor. It may 
also specify the types of input to be accepted and the types 
of output to be produced by the processor. 

Processors can be created, updated, and deleted under nor- 
mal batch operations, and there are no restrictions as to how 
many and what kind of processors may be added to the system. 

User programs in any area of the disk con be called by 



r 



IRUN fid 



where fid is the file identifier for the load module to be 
executed. 

All system processors and user processors in the SP area or 
system processor alternate area can be called for execution 
by the control command: 



r 



{name parameters 



where 



nome is the disk file name of the processor to be 
executed (e.g., FORTRAN, SL-1, or A P. Note 
that the disk file name for the Assembly Program 
should be Ap, since the JCP does special alloca- 
tion of the BT oreo if |AP is encountered. 
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Processor Control Commands 



porcmeters are optional parameters interpreted by 
each processor. Normally, of least one input' 
option and one output option must be specified. 



PROCESSOR INTERFACE WITH CP-R 

The stondard system processors available under CP-R are 

Assembly Program (AP) 

Overlay Loader 

RADEDIT 

Edit 

Extended FORTRAN IV 

Dump Analysis Program (ANALYZE) 

SL-1 

Error Log Lister and Analysis (ELLA) 

Device Exerciser 

System processors and any user processors should follow these 
common ground rules: 

1. All processors must reside on the SP area or system 
processor alternate area of the disk to be callable by 
a I name command. 

2. All processors must operate in the background. 

3. All system DCBs (Mrdcb) should be identified as a 
primary reference in the processor, since at load time 
the Overlay Loader will furnish the processor with a 
copy of the system DCBs . 

4. All processors with overlay segments need only make 
the explicit call to SEGLOAD to load the segments. 
The DCB used to load segment M:5L will be furnished 
by the Overlay Loader. 



CP-R will furnish the start address and end address 
of unused background memory to any processor that 
needs this information. The two addresses will be in 
the following locations, and should be defined via the 
EQU directive in the processor: 



Location 



X'153' 



Mnemonic Description 

K:BPEND LWA + 1" of the back- 

ground program's loaded 
area; that is, this eel I 
contains the FWA tt the 
processor can use for a 
dynamic table area. 



All these addresses are in bits 15-31 with bits 0-14 con- 
taining zeros. 

AM 

LWA and FWA are the last word address and first word 
address. 



Location Mnemonic Description 

X'141'* KrBCKEND LWA of usable bock- 

ground memory for the 
processor; that is, this 
cell contains the LWA 
the processor can use 
for a dynamic table 
area. 

6. If a processor hat parameters to process from the " (name" 
control command (where "name" is the processor's name) 
the address of the buffer containing the control com- 
mand is in cell X*144'. That is. 

Location Mnemonic Description 

X'144' t KsCCBUF Address of control card 

buffer. 



7. A processor must perform its own vertical format con- 
trol of the printer if format control is required. That 
is, the processor must set the VFC (vertical format 
control) bit in the DCB via the Device Format Con- 
trol call and ensure that the first byte output to the 
printer is a format control byte. If a processor (i.e., 
AP) outputs a title at the top of each page, the num- 
ber of lines to print per page is contained in the 
following system cell: 



Location Mnemonic Description 

X'174' K:PAGE Number of lines per page 

byte to print. 



If a processor uses scratch files (background temp 
files X1-X9) and desires a different record size, gran- 
ule size, or organization that is given by default by 
the JCP, the processor must make the appropriate sys- 
tem call on the Device Mode function. By calling the 
Device Mode function, the processor can set the file 
organization (blocked or compressed) and the appro- 
priate record size and granule size. The background 
temp file default assignments by the JCP are described 
below. 



9. In general the processor should terminate input from 
SI when an end-of-file status is sensed on SI. To ter- 
minate, the processor should make a system cal I on 
EXIT. EXIT will close all the processor's DCBs and 
close all open disk files. 



10. All processors using the GO file should open GO and 
then do a file skip (PFIL function call) on GO so the 
GO file is properly positioned to receive additional 
data. The Job Control Processor will purge the GO 
file upon reading a JOB control command. 
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jCPwill allocate the Background Temp area lor all X? files, 
where, 1 i 9. The GO and OV files will receive their 
SYSGEN defined sizes unless overridden with an ALLOBT 
command. The GO file will be defined as a blocked file 
with a logical record size of 120 bytes; the OV file will 
be unblocked with the record and granule sizes equal to the 
sector size. The Background Temp area that remains after 
GO and OV have been allocated will then be equally dis- 
tributed among the Xi files. All Xi files will be given un- 
blocked organization with the record and granule sizes 
equal to the disk sector size. The user can override any of 



these defaults via an ALLOBT command. If the user desires 
not to have the Xi files reallocated between processors, 
the SAVE option on the ALLOBT command can be used. 



JCP MESSAGES 

The messages itemized in Table 6 are output by the Job 
Control Processor on the LL device. 



Table 6. JCP Messages 



Message 


Meaning 


1 JACCT LOG I/O ERROR X'xx' 


An I/O error that could not be automatical ly processed was encountered 
during JCP execution. CP-R will enter a WAIT state if the (ATTEND 
control command was first read in; otherwise, an abort and a skip to 
the next job will occur. 


IIBICKSMERR 
NBISEQERR 


JCP Loader encountered a checksum or sequence error on a binary 
card during the loading process. 


1 IBT OVERFLOW 


Insufficient Background Temp space to execute the requested back- 
ground program. The job is aborted. 


1 ICC ERROR, BT OVERFLOW 


The file size input on an IALLOBT command is greater than the 
available Background Temp space. 


1 ICC ERROR, FG KEY-IN REQUIRED 


A request has been made to run a foreground program without pre- 
viously inputting an FG key-in. The ! RUN or IROV command must 
be reentered after the FG key-in is input. 


1 ICC ERROR, ILL. 
RELOCATION OF BT 


An improper IALLOBT command was input to change a Background 
Temp (BT) scratch file that was designated as a "saved" file prior to 
this job step. 


1 ICC ERROR IN ITEM xx 


An error exists in a JCP control command in the indicated item. Every 
item (except the ! character) followed by a blank or comma is 
counted in determining the item in error. 


! ID1 AREA FGD, CAN'T UPDATE AL RLE 


JCP could not process accounting information because the Dl area on 
disk has been reserved tor foreground. CP-R will enter WAIT state if 
an IATTEND control command was specified; otherwise, an abort and 
a skip to the next job will occur. 


I !EOT ON FILE xxxxxxxx 


End-of-Tape status was returned from an attempt to read or write the 
indicated disk file. 


1 IERR, CONTROL BYTE = xx 


JCP Loader is not equipped to process the indicated control byte. 


1 1 FILE xxxxxxxx NONEXIST. 


The indicated disk file was never allocated via the RADEDITor was 
never written into. 


HILL. DEFINE HELD ITEM 


JCP Loader has encountered a define field item that it is not equipped 
to handle. 


IHLLEGAL BINARY CARD 


An EBCDIC card was read by the JCP Loader where a binary card was 
expected. 
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Table 6. JCP Messages (oont. ) 


Message 


Meaning 


MILL EXPRESSION 


JCP Loader has encountered an expression that it is not equipped to 
evaluate (a mixed resolution expression). The lood will be aborted. 


HILL NEC ORG ITEM 


JCP Loader has encountered an origin item that it is not equipped to 
handle (an origin item that moves the load location counter in a 
negative direction). The lood will be aborted. 


III/O ERROR X'xx', LOC 'xxxxx' 


JCP encountered an irrecoverable I/O error. 


IILMI FULL, CAN'T LOAD xxxxxxxx 


The indicated foreground program cannot be loaded because insuffi- 
cient space exists in the Load Module Inventory table. 


! I NOT A TASK LOAD MODULE 


A RUN command has named a file without a valid lood module header. 
The RUN command is aborted. 


! INOT ENUF SPACE FOR LOAD 


JCP Loader is unable to complete the load because of insufficient 
background space. 


1 IPUB LIB, CAN'T LOAD xxxxxxxx 


The designated program on the IRUN command isa Public Library and 
cannot be executed via a IRUN command. 


I1SCHEDFILE OVERFLOW 


File SCHED in the SP area is full thus discarding all future requests 
for periodic scheduling. File should be copied and enlarged. 


! 1SCHED FILE TYC 'xx' ON 'operation' 


The type completion 'xx' was received on the 'operation' indicated 
or the file SCHED in SP. Refer to Appendix N for TYCs. 


IISCHING FORJOBCMD 


The present job has been aborted and the JCP is searching the job 
stack for the next I J OB or IF1N command. 


! ! 'raskname' IN ' jobname' MISSED 'xx' CYCLES 


The task indicated In the job indicated missed 'xx' initiations by the 
periodic scheduler. 


1 1 'raskname' IN 'jobname' 
TYC 'xx' [DELETED] 


The task indicated in the job indicated received the type completion 
'xx' when an INIT was attempted by the periodic scheduler. The 
entry was deleted if indicated. Refer to Appendix N far TYG. 


I ITOO MANY ASSIGNS 


JCP has encountered more than 48 IASSIGN commands in a job step. 


! ITOO MANY CONTROL SECT. 


JCP Loader has encountered more than one nonstandard control 
section. The load will be aborted. 


1 ITOO MANY DCB'S 


The maximum number of M: and F: DCBs was exceeded during the 
loading process. Approximately 27 DCBs can be accommodated by the 
system. The excess DCBs will not be stored in the DCB table or the 
disk file header. 


1 (UNSATISFIED REF xxxxxxxx 


Indicated REF was not satisfied during the loading process. This 
alarm occurs only on LL if no map was requested, or on LO if a map 
was requested. 


1 IUNSATISFIED REF's DURING LOAD 


This message is typed to the operator on OC at the end of a load if 
any unsatisfied REFs were encountered during the loading process. 


1 IWARN1NG: NONEXIST. 
FILE xxxxxxxx 


JCP has processed an (ASSIGN command that assigned a DCB to a 
nonexistent file. JCP will continue normal processing. 
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3. OPERATOR COMMUNICATIONS 



Communications between the operator and the system take 
place through operator key-ins (solicited and unsolicited) 
and monitor printouts (CP-R messages). 



CP-R MESSAGES 

CP-Rand associated processors (as selected during SYSGEN) 
output messages on the OC device whenever operator action 
is required or to inform the operator as to the status of events 
(including errors)taking place within the system. CP-R out- 
put messages are listed and described in Table 7. 



I IMEM. PARITY ERR AT xxxxx ID = xxxxxxxx 
1 IMEM. PROT. ERR AT xxxxx ID = xxxxxxxx 
I INONEXIST. ADD. AT xxxxx ID = xxxxxxxx 
IINONEXIST. INST. AT xxxxx ID = xxxxxxxx 
1 (PRIVILEGE INST. AT xxxxx ID = xxxxxxxx 
I ISTACK OVERFLOW AT xxxxx ID = xxxxxxxx 
MUN1MPLE. INST. AT xxxxx ID = xxxxxxxx 
I IWDOG TIMER RUNOUT AT xxxxx ID = xxxxxxxx 



TRAP HANDLER MESSA6ES 

In addition to the messages fisted in Table 7, the following 
messages are output by the trap handler upon occurrence of 
the various traps if the user does not specify his own trap 
handling: 

I IARITH. FAULT AT xxxxx ID = xxxxxxxx 

1 (BREAK ERROR AT xxxxx ID = xxxxxxxx 



Note that the message "ARITH. FAULT AT xxxxx" is output 
for the fixed point arithmetic overflow trap, the floating- 
point fault trap, and the decimal arithmetic fault trap. The 
message 

"ERRxx ON CAL AT xxxxx ID = xxxxxxxx" 

is output if a user program furnishes on invalid parameter 
while attempting to use a service function. ID identifies 
the trapped task. 



Table 7. CP-R Messages and Responses 



Message* 


Meaning 


Operator Action 


1 lyyndd **** message 


"yyndd" k the control device and job 
name for the terminal job. "Message" 
is the message sent by the terminal 
user to the operator. 


Action is determined by the content 
of the terminal user's message. 


1 lyyndd ATTENTION INTERRUPT 


An attention interrupt was received 
from the specified device. 


No action is required. 


I lyyndd ERROR m 


An irrecoverable error has occurred. 


No key- in response required except 
for card reader. For card reader error, 
remove last card in output hopper for 
jam and replace it or a duplicate to 
input hopper. Key in CRndd R®. If 
card or reader cannot be fixed, key 
in CRndd E © to inform the request- 
ing task the card reader emaced. 


Messages beginning with 1 lyyndd in the message column will vary according to device type. Therefore the second words 
in such messages are listed alphabetically. 

If background, requires an I/O key-in to continue or retry I/O operation on the device; if foreground, the operation is 
errored and no key-in is required or expected. 

Key-in may be required depending on device type. 
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Table 7. CP-R Messages end Responses (cent. ) 



Message 


Meaning 


Operator Action 


1 lyyndd ERROR, NOT OPERATIONAL 


Device went not operational during 
I/O operation. 


No action required. 


1 lyyndd ERROR, POSITION LOST 


A magnetic tape unit either returned 
inconsistent status or the tope posi- 
tion is indeterminant following a tape 
operation. 


No action required. 


! lyyndd I/O TIMED OUT* 


An I/O interrupt failed to return 
from the device used for an I/O 
operation in the software timeout 
period allowed. 


Unless the timeout occurred in a 
foreground task, the message always 
requires operator action. If the 
cause and/or correction is unknown, 
key-in yyndd E©. If the cause is 
known, key in either yyndd R© or 
yyndd C© to specify whether the 
I/O operation should be or should 
not be retried. (R specifies retry; 
C specifies continue. ) 


1 lyyndd KEY-IN PENDING 


An I/O operation is waiting for an 
operator key- in on the indicated 
device. This message is repeated 

at intervals. 


Supply the appropriate key-in. 


1 lyyndd MANUAL 


Device was in manual mode at SIO 
initiation. 


Ready the device. No key-in is 
required. 


1 lyyndd SIO REJECT, CC = 10 — n 


SIO instruction returned CCI end 
CC2 as nonzero (10). 


Correct condition end key in yyndd 
R© . If condition cannot be repaired, 
key in yyndd E© to inform task the 
I/O has errored. 


1 lyyndd SIO REJECT, CC = 01 — n 


SIO instruction returned CCI end 
CC2 as nonzero (01). 


Correct condition and key in yyndd 
R©. If condition cannot be repaired, 
key in yyndd E© to inform task the 
I/O has errored. 


1 lyyndd TEST MODE 


Device went into test mode during 
I/O operation. 


No action required. 


1 lyyndd UNRECOGNIZED" 


SIO instruction returned CCI end 
CC2 as nonzero (11). 


Correct condition and key-in yyndd 
R®. If condition cannot be repaired, 
key in yyndd E© to inform task the 
I/O has errored. 


1 lyyndd WRITE PROTECTED" 


An attempt was made to write to a 
write protected device or disk track. 


If the write is to be permitted then 
change the write protected status of 
the device or track and key in yyndd 
R ©. If the write is not to be per- 
mitted, key in yynda*E©. 


1 IALARM xxxxxxxxxx 


A system inconsistency was detected, 
following the ALARM message. The 
reason is indicated in the text. 


See Chapter 5, "Availability Oper- 
ating Procedures". 


I! BACK GROUND IDLE 


Background sequencing has been termi- 
nated because J CP read a 1 FIN command 
or encountered a critical error. 


If more background jobs are to be 
run, key in C to restart background 
sequencing. 
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Table 7. CP-R Messages end Responses (cent. ) 



Massage 


Meaning 


» 

Operator Action 


1 (BACKGROUND WAIT 


Background hat executed a "WAIT" 
request. 


Key in C to continue background 
processing. 


! IBKG ABORT WAIT 


Background has aborted in attended 
mode* 


Key in "C" to continue, or "DB" to 
dump background memory. 


IJBKGD JOB ident ON 


Specified background symbiont job 
has been selected for execution. 


No operator action required. 


! 1CANT OPEN ERRORLOG 


The error log file was already in use 
by error list program, full RFT, no 
blocking buffer available, or a DED 
key-in was in effect. 


See Chapter 2 Availability Manual. 


I ICORE SAVED 


Memory has been saved on the CK 
area following a system fault. 


No action required. 


! ICORE USED, CAN'T 
LOAD xxxxxxxx 


The specified primary program cannot 
be loaded for execution because its 
required core space is already in use. 


Key-in X © to abort the job. 


I ICP-R RESTARTED 


CP-R is fully restarted following a 
system ALARM and an auto-restart. 
The date and time information have 
been maintained and need not be 
re-entered. 


No action required. 


1 ICRndd CARD NOT FED tf 


The card reader was unable to feed 
a card correctly. 


Corrector replace the card in the read 
hopper. Push RESET START and key in 
CRndd R®to retry the operation. 


MDPnddlDLE 


Indicated unit has no open files. 


May be removed from the spindle. 


1 J ERRORLOG ERROR 


An irrecoverable write error was en- 
countered while attempting to write 
entries to the ER operational label. 


Reassign ER op label to another output 
device or "0". 


! 1 ERRORLOG FULL 


While attempting to write entries to 
the ER operational label, an end-of- 
file, end-«f-dota, or end-of-tape 
was encountered. 


See Chapter 2 for Error Log purging 
procedures. Availability Manual. 


! (FILE NAME ERR 


A problem has occurred in attempting 
to open or close a disk file through 
an STDLB key-in. 


Key-in X © to abort the job. 


! II/O ERR, CAN'T LOAD xxxxxxxx 


An I/O error occurred or no blocking 
buffer was available when attempting 
to load the specified foreground pro- 
gram for execution. 


Key-in X © to abort the job. 


1 1JOB account, name, priority, ident 


An input job was added to a list of sym- 
biont files. Message has some format as 
user's job card except for ident, which 
is added to the end. 


No action required. 


I! KEY ERR 


CP-R cannot recognize an unsolicited 
key-in response. 


Retry the key-in. 
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Table 7. CP-R Messages and Responses (cent. ) 



Manage 


Moaning 


Operator Action 


1 ILMI FULL, CAN'T LOAD xxxxxxxx 




The specified primary program cannot 
be Ic aded for execution because no 
room exists in the Load Module 
Inventor/. 


Key-in X © to abort the job. 


1 i LOADED PROG xxxxxxxx 


Specified primary programs were 
loaded by Foreground Loader for ex- 
ecution. Up to three program names 
will be output in one message. 


No action required. Outpurting of 
this message to OC may be prevented 
by setting appropriate assembly time 
software switch to bypass the code 
causing the message. 


i (MEDIA ABORTED REQ xxxxtyyyy 


MEDIA request xxxx was aborted due 
to reason yyyy where yyyy can be 

OPER - operator keyed in "X" 

NOMO - the MO oplabel is not 
defined 

OPNI - unable to open input file's 
DCB 

OPNO - unable to open output 
file's DCB 

PREP - an irrecoverable error 
occurred during 
preprocessing 

BUFS - insufficient job reserved 
pages for blocking buffers 

DEV - a fatal error occurred 
during the copy 

SPEC - invalid specifications were 
detected 


None. If request xxxx was initiated 
by an operator or MEDIA key-in and 
the cause of the abortion removed, 
the key-in can be reentered. 


! IMED1A MOUNT TAPES FOR xxxx 


MEDIA request xxxx is reody to begin. 


Mount tape or tapes required. When 
ready, key- in MEDIA I to initiate 
copy. 


1 (MEMORY FAULT 


During a memory status scan, memory 
status was found which indicated that 
an error was detected by the memory 
unit. An error log entry was recorded 
for this problem. 


No action required. 


UNO PATCH AREA - CLEAR B S 
IGNORES MODIFY COMMAND 


If this is OC, only the message portion 
preceding the hyphen is output. If not 
OC, the entire message is output. 


If this is OC, input next command. 
If not OC, idle machine, increment 
address, and RUN. 


IINOTSPACE, CAN'T 
LOAD xxxxxxxx 


A primary program load request could 
not be satisfied because TSPACE was 
not available for building FPTs or for 
reading in the heoder. 


Key in X © to abort the job. 


MNONEXIST., CAN'T 
LOAD xxxxxxxx 


Specified program cannot be loaded 
for execution because it does not exist 
on disk, or required Public Library 
does not exist on disk. 


Retry. If message is output again, 
key-in X © to abort the job. 
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Table 7. CP-R Messages and Responses (oont. ) 



Message 


Meaning 


Operator Action *' 


1 ! PATCH LOC ERR-CORRECT AND 
CLEAR B $ 


If this is OC, only the message portion 
preceding the hyphen is output. If not 
OC, the entire message b output. 


If this is OC, input next command. 
If not OC, idle machine, increment 
address, and RUN. 


1 1 PAUSE commands 


A 1 PAUSE command has been reod. 
Comments field will have operator 
instruction. 


Press INTERRUPT switch and key in 
C © to continue reading from the 
job stock after performing required 
action. 


1 1 PLEASE KEY-IN DATE-TIME 


CP-R has been booted in and requires 
the date and time before other opera- 
tions are allowed. 


Enter DT i_i mm, dd, yy, hh, mm 

where 

mm - month (1-12) 
dd - day (1-31) 
yy - year (00-99) 
hh - hour (0-23) 
min - minute (0-59) 


I (PROCESSOR FAULT 


During a processor status scan, pro- 
cessor status was found which indicated 
that an error was detected by a pro- 
cessor. An error log entry was recorded 
for this problem. 


No action required. 


MPUB LIB, CAN'T LOAD xxxxxxxx 


Invalid request to load Public Library 
for execution. All Public Libraries 
must be automatically loaded by the 
system as needed. 


Either retry the fob or key in X© to 
abort the job. 


!! QUEUED AS NUM. xxxx 


MEDIA copy request is accepted and 
is assigned ident number xxxx. 


No action required. 


1 (RELEASED PROG xxxxxxxx 


Specified primary program was 
released. 


No action required. Message can be 
prevented by setting appropriate 
assembly time software switch to by- 
pass code causing the message. 


I !RLS NAME NA 


Key-in request to release a foreground 
program whose name is not recognized 
by the system. 


Retry. 


! (SPURIOUS EXTERNAL INTERRUPT 


An interrupt has been triggered but is 
not connected to a task. 


No action is required. 


I ISyyndd ERR xx 


An irrecoverable error occurred. Sym- 
biont activity on specified device was 
terminated. 


No action required. 


IISyynddlDLE 


Specified symbiont device entered 
idle state. 


No action required. * 


1 ISyyndd UNAVAILABLE 


Specified device is currently unavail- 
able to the symbiont. 


No action required. 


1 ITERMINAL JOB yyndd 
account, name OFF 


Indicates the terminal user is now in- 
active, "yyndd" is the control device 
and job name for terminal fob. "Account, 
name" is logon verified user account, name. 


No action required. 
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Table 7. CP-R Messages and Responses <oont. ) 



Message 


Meaning 


Operator Action 


IITERMINALJOB/yndd 
account, name ON 


Indicates the terminal user b now 
active, "yyndd", is thi control de- 
vice and job name for terminal job. 
"Account, name" is logon verified 
user account and user name. 


No action required. 


! (UNABLE TO CLOSE DCB xxxxxxxx 


The specified DCB was not closed in 
the task during termination. 


No action required. 


! 1 XEROX CP-R VERSION xxxx 


Output whenever system is booted in. 


Message can be terminated by 
hitting BREAK key on OC. 



OUTPUT MESSAGE FORMATS 

Output messages are printed in three different formats on 
the Operator's Console. These formats ore outlined below. 

1. Messages without tabs are for operator's reference 
at a later time and ore typically generated by fore- 
ground or background programs that wish to communi- 
cate with the operator. They are similar to system 
messages but have no time stamp. 

2. System messages which begin with two exclamation 
marks (I I) will be preceded by a time stamp (hhsmm) 
in column 1 through 5, followed by a single tab. With 
normal fab settings the message will be positioned 1 inch 
to the right of the left margin. 

3. Device control messages will have a time stamp in col- 
umn 1 through 5, followed by four tabs. With normal 
tab settings the message will be positioned 4 inches to 
the right of the left margin. 



OPERATOR KEY-W 

After the system has been initialized, operator key-ins 
permit the operator to control the execution of tasks by the 
system (i.e., foreground tasks, background Job stream, and 
Control Task services). 

With the exception of the DT key-in (which is requested by 
the system at the end of system initialization but prior to 
any other activity, if fob accounting or error-logging has 
been requested), operator key-ins ore unsolicited. That is, 
on operator key-in is initiated by the operator depressing the 
INTERRUPT switch on the Control Panel. (On a Xerox550, 
the ATTENTION key may be substituted. ) This oction 
activates the Control Panel Task which, in turn, triggers 
the CP-R Control Task. When the Control Task becomes 
the highest priority task in the system (that is, when all 
foreground tasks are inactive ), the system issues a prompt 



character (a dash, "-") to the Operator's Console and waits 
for operator input. 

Vio the OC device, the operator inputs appropriate infor- 
mation in the following sequence: 

1. Optionally, types in an exclamation mark (I). 

2. Types in the desired key-in and any associated pa- 
rameters. (Refer to Tables 8 through 11 for listing 
and description of Standard, Terminal Job Entry, 
Symbiont, and Media Conversion key-ins. ) 

3. Types in a New Line character© to indicate the com- 
pletion of a key-in. 

If a typing error is discovered before the © character has 
been keyed in, the error may be corrected by the operator 
in one of the following ways: 

1. If the erroneous character b the last character typed, 
key in one cent sign {/) character, retype the last 
character correctly, and continue to type in the re- 
mainder of the key- in. indicate completion of cor- 
rected key-in by keying in the © character. 

2. If the erroneous character is within a fe* positions of 
the last character typed, key in an appropriate number 
of cent signs (storting with the last character, each 
cent sign deletes one character and performs a simulated 
backspace of one position) until the erroneous character 
has been effectively deleted. Retype correctly, all 
characters deleted and resume typing rest of key-in. 
Upon completion of key-in, key in 1he © character, 

3. If the erroneous character is located toward the begin- 
ning of the key-in or many positions from the last char- 
acter typed, it may be more expeditious to key in an 
EOM (End of Message) character. In this case, the 
entire key-in is deleted and the monitor is ready for a 
new key-in. 
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Table 8. Standard Operator Key-Ins 



Key-In 


Purpose ' 


yyndd a © 


Controls system action following on abnormal condition during an I/O 
operation, where "yyndd" is the physic il device name of the device in- 
volved, end "a" is a single character that requests a system action relative 
to the device as follows: a = C — continue "as is"; a = E — inform user pro- 
gram of the error and transmit record "as is"; a = R — retry the I/O opera- 
tion; a = X —unconditionally abort the current operation on the device and 
error the request. 


ALARM© 


Forces an operator-initiated system alarm. See also REBOOT key-in. 


*"P> 


If OFF, the batch control command (ATTEND becomes illegal. If ON, both 
the (PAUSE and 1ATTEND control commands become legal. This command 
allows the system to permit or reject batch }obs that depend upon the pro- 
grammer being able to interact with his job. Default is ON. See also PAU 
key- in. 


BMEM[n] © 


Change memory allocation for the background job. The "n" specifies the 
number of pages to be allocated to the background job. If "n" is not spec- 
ified, its background job memory is restored to its SYSGEN-defined value. 
Allocations for background tasks using simplified memory management (SMM 
option on the IOLOAD command) will not take effect until the current back- 
ground fob step terminates. 


BREAK jobname © 


Transfers control to user's break-receiver routine if the user established break 
control in the job via an INT service call, jobname is the name of the job to 
receive the break signal . 


c [s/o]© 


If no parameters: Continue processing in the background. If the background 
was in a wait or idle state, the system leaves that state and proceeds. If "S" 
parameter; Change the background control mode to symbiont, so the sym- 
biont can start background when necessary. If "O" parameter: Change the 
background control mode to operator, so only the operator may start back- 
ground. The symbiont can only start background from an idle state. It can 
not clear a background wait. 


CC© 


Retransfer control back to the C device from OC. Used in conjunction with 
TY key-in. 


^cri.' 


D 
A 
T 


© 


Disarm, arm and enable, or trigger specified interrupt. The "location" spec- 
ifies the hex address of the interrupt; "label" specifies an interrupt label; 
"D" is used to disarm specified interrupt; "A" b used to arm and enable; 
"T" is used to arm, enable, and trigger the interrupt. 


e »(at>«*ie 


Selectively dump system output saved in the CK area after a system alarm. 
The "ioaddr" parameter specifies the lowest address to dump. The "hjaddr" 
parameter specifies the highest address to dump. Default eases for "Tooddr" 
and "hioddr" are and high core respectively. Activation of the Control 
Panel Interrupt during the MAP portion of the dump stops map output and 
starts the DUMP portion. Activation of the interrupt during the DUMP por- 
tion terminates the dump. 


COC © 


Job was halted because of error in control command. Continue from OC with 
correct control command (after depressing the Control Panel Interrupt Key). 
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TabU 6. Standard Operator Key-Ins (cent. ) 



f 



Key- In 


niipose - - 


HEZ.I**}®. 


Identical to CKD key-in above except that the dump is read from the SE 
oplabel rather than the CK area (see CRS key-in below). 


CRS© 


Preserve an alarm dump by copying it from the CK area to the SE oplabel in 
1024-byte records. 


DEBUG taskname[,(JOB,jobname)]© 


Causes the named task in the named job to be run under DEBUG control. 


(und}^**' 


F 
X 
N 
D 
R 


O-'ol] 


© 


DED dedicates a device, device controller, or lOP. UND undedicates a 
previously dedicated device, device controller, or lOP. F defines the de- 
vice to be dedicated to the foreground; X prevents device use and aborts any 
existing requests; N prevents device use but does not abort existing requests 
for use; D restricts a device for diagnostic use and aborts any existing re- 
quests; R specifies that the disk pack will be removed (DED) or has been re- 
placed (UND) from unit DPndd; 1 dedicates or undedicates all devices on 
!OPn (of yyndd); D dedicates or undedicates only device yyndd. If neither 
1 nor D is specified, all devices on the same multiunit controller are dedi- 
cated or undedicated. 


display[ll]© 


Display current status of all tasks m the system on the LL or OC device. 
Output is to the OC device unless LL is specified. A typical display output 
is shown in Figure 3. 




DM 

DF 

DB 


[from,to][,r)[,S]© 


Dumps the contents of specified memory onto the device that k permanently 
assigned to the DO oplabel. DM specifies a real-memory dump with default 
boundaries being zero and the end of the monitor. DF specifies a real-memory 
dump with default boundaries being the limits of the first Foreground Private 
Memory partition. DB specifies a virtual-memory postmortem dump of back- 
ground with default boundaries as the limits of Taste Virtual Memory. 

DF or DM requests are performed immediately. A DB dump request is not per- 
formed until the next task termination occurs in background (either for JCP or 
any other processor or user program). 

If "from, to" is absent, the entire default area will be dumped; if present, the 
first word address in hex and last word address in hex of the selected area are 
defined. If ", T" is absent, core memory is dumped in hexadecimal; if present, 
core memory is dumped in hexadecimal and EBCDIC. 'S' specifies the dump 
will be in a short-line format at four words per line. 


DT mo,day,yr,hr,min © 


Input of current data and time. Example: DT 8, 17, 69, 22, 30. 


ELOG 


ON 
OFF 
PURGE 


© 


Turns error logging procedures on and off. Eliminates the majority of the 
execution time overhead associated with error logging but does not prevent 
gathering of the error statistics for the ESUM display. PURGE clears the 
error log and all error, log and I/O counts. ^ 


JERRSEND) ir ~, 

Iesend I**' 


Creates an error log entry containing the supplied text (56-byte maximum). 


esum[ll] © 


Display a device error summary on OC or LL. A typical error summary is 
shown in Figure 4. 
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Table 8. Standard Operator Key-Ins (cant. ) 



Key-In 


Purpose 


EXTNAtaskname[, (JOB, jobname)] © 


Terminate a task in a job. The "taskname" is the name of the task to be 
terminated. "JOB" is a keyword that indicates that the job under which the 
task is running will be specified. (If JOB is absent, jobname defaults to the 
CP-R job. ) The "jobname" is the name of the job under which the task to be 
terminated is running. 


FG© 


Permit loading of foreground program from background job stack for execution 
via a !RUN or UNIT control command.' 


1NIT fid[, (JOB, jobname )][, PRl] . 

L— [,STOP][.. (PRlO,xxxx)] 1 

1 [,DEBUG][,TS]© 


Read named task into memory and initiate it. The fid is the file identifier for 
the load module file. "JOB" is a keyword that indicates that the task is to 
run under a job other than the CP-R job (if "JOB" is not specified, the task 
runs under the CP-R job). The "jobname" specifies the name of the job under 
which the task is to be run. PRI specifies the task is primary and if not spec- 
ified the task is run as secondary. STOP is an option that specifies the task 
(secondary only) is to be left in suspended state after load. The default is to 
execute directly after load. PRIO is a keyword to specify task priority (for 
secondary tasks only). Default is to run under lowest-priority dispatcher at 
lowest software priority. This is X'EFEF' for nontimesliced tasks or X' FFFF' 
for timesticed tasks, xxxx is the task's priority value (in hex). The first 
2 characters specify the interrupt level minus X'4F' of the task's dispatcher, 
and the last 2 characters specify the task's software priority. DEBUG indi- 
cates the task is to be initially under Debug control. TS indicates that the 
task is to be time-sliced. 


INTLB label, loc (hex)© 


Change assignment of interrupt labels. 


KJOB jobname© 


Terminates all tasks in the named job. 


™[a] e 


If OFF, both the .'PAUSE and 1 ATTEND batch control commands become 
illegal and any I/O operation which would otherwise have mode a request 
for an operator's key-in to correct an I/O problem is aborted with a TYC4, 
If ON, only the ! PAUSE command becomes legal. This command allows the 
system to permit or reject batch jobs that depend upon operator interaction 
(e.g., tape mounting) to continue. Default is ON. See also ATT key-in. 


Q 


(SLICE, n) 
(QMIN,t) 

(QSWA,t) 
(QMAX,t) 


i ■ 1 


© 


If no parameters are used, the current settings of the time-slicing controls 
are reported. These parameters are number of slices per second; and slice 
length, QMIN, QSWA, and QMAX in milliseconds. If parameters ore spec- 
ified, the corresponding controls are set as specified. The parameter "n" is 
a decimal number of slices per second that must be between 1 and 500, and 
must divide 500 evenly. The parameter "t" is milliseconds (decimal) and 
must be 1 or more. 


. Q30 


NORETRY 

RETRY 

NOPARITY 

PARITY 

NOWDT 

WDT 


i •• • 


© 


This command is available on a Xerox 550 system only. It affects the con- 
tents of the Q30 register os follows: 

-A 

NORETRY: set bit No instruction retry 

RETRY; reset bit 

NOPARITY: set bit 1 No parity checks 

PARITY: reset bit 1 

NOWDT: set bit 2 No watchdog timer 

WDT: reset bit 2 

Default is no change for each bit. 
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Tabic 8. Standard Operator Key-Ins (cent. ) 



Key-In 


nirpose 


Q31 [option,...]© 


* 
This command allows simple examination and modification of the address stop 
controls (Q31 register) of a Xerox 550 system. It is not available on a 
Sigma 9 system. The "options" are any of the following: 

(AD DR, x) Set address to "x" (hexadec imal ) . 

(Symbol, x) Set address to H x" plus the value of "symbol". "Symbol" 

may be any symbol found in the symbol table in module 

CRS2 or any overlay name. 
(STM, x) Set address to "x" plus X'6000'. 
(ROOT,x) Set address to "x" plus X'oOOE". 
INST Compare execution access addresses. 
WRITE Compare write access addresses. 
ANY Compare any addresses accessed. 
ALL (Same as ANY. ) 
PAGE Compare page addresses. 
WORD Compare word addresses. 
REAL Compare real addresses. 
VI RT Compare virtual addresses. 
STOP Stop execution on compare. 
HALT (Same as STOP. ) 
BEEP Briefly sound audio alarm on compare. 
CLEAR Reset all flag bits (but save the address). 

Any bit or field not specified is not changed. If no options are specified, the 
Q31 register content is typed as a hexadecimal number. 


REBOOT © 


Forces an operator-initiated system alarm and an automatic reboot of the 
system. See also ALARM key-in. 


RLS taskname 


Terminate a foreground primary program running under the CP-R job. 


RSY[jobname] 


Removes SY key-in for the specified job, returning to normal software disk 
write protection. Default for 'jobname' is 'BKG' which is the background 
job. Note that the SY key-in is automatically removed from background 
whenever a J JOB or IFIN command is processed. 


RUN taskname [, priority] © 


Load and execute a foreground program running under the CP-R job. Only 
primary tasks can be loaded with this key-in. The name of the foreground 
file to be loaded must be input. 


SCHED fid [, (JOB,jobnome)][, PRI] — . 


Schedule a task for periodic INIT. The "fid" is a CP-R file identifier with 
one variation: the file name is actually a task name that may be the same 
as the file name or related to it by a SETNAME CAL. 

If neither an account nor an area is specified, the defaults are area FP and 
the system account. If an area name is specified, the default is the system 
account. Specification of a whole area is an error. 

JOB is a keyword indicating that the task is to be INI Ted under a job other 
than the CP-R job. The defaultis the CP-R job. PRI specifies a primary task; 
the default is secondary. PRIO is a keyword to specify task priority for sec- 
ondary tasks. Default is to run under lowest-priority dispatcher at lowest soft- 
ware priority. "XXXX" is the task's priority value in hex. The first two char- 
acters specify the interrupt level minus X'4F' of the task's dispatcher, and 
the last two characters specify the software priority. TS specifies a time- 
sliced task. DELETE specifies that the task is to be de-scheduled. STRT is a 
keyword indicating that the time for the first INIT to the task is specified. 
A value of zero or absence of the keyword causes an immediate INIT. 


1— [, (PRIO, xxxx)][, (5TRT,time)] — | 


' [, (INTV,intervaf )][,DELE[TE]]— j 


1 — Dts] 
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Tabic 8. Standard Operator Key-Ins (cont. ) 



Key-In 


Purpose 


SCHED fid (cont. ) 


The format of the time values for start time is as follows: 




il[[[[> rr »] mm »] dd »3 nn f]''> in,] sec] 




where 




yr means year (e.g., 76) 

mm means month number (e.g. , 9) 

dd means day (e.g., 5) 

hh means hour (e.g., 14) 

min means minute (e.g., 30) 

sec means second (e.g., 10) 




Values are optionally deletabfe from left to right; e.g. , any value may be 
omitted provided that all parameters to its left are ofso omitted. Thus, if 
hh is omitted, yr, mm, and dd must also be omitted. The SCHED key-in 
uses current date/time values for omitted values. An exomple of the STRT 
option is: 




...(STRT, 14,30,0)... 




which would cause the specified task to be INITed at 2:30 p. m. of the cur- 
rent year, month, and day. Please note that omission of the (seconds) 
value would cause INIT at 14 minutes and 30 seconds of the current year, 
month, day, and hour. 




1NTV is a keyword indicating that the period between INITs is specified in 
seconds. If the specified value is not an integral multiple of five, it is 
rounded up to the next highest integral multiple of five. A value of zero or 
absence of the parameter causes the INIT to be issued once at the specified 
STRT time. The presence or absence of the STRTandlNTV keywords is inter- 
preted a follows: 




1NTV STRT Result 




present absent periodic INIT, starting at now + INTV 




present present periodic INIT, starting at STRT 




absent absent INIT once immediately 




absent present INIT once at STRT 


SJOB jobname [,(DEBUG,TYndd)]©—. 


Creates the named foreground job by setting up job controls and table entries 
but does not initiate any task in the job. DEBUG indicates a Debug control- 
console device is specified. TYndd is the address used by Debug for communi- 
cation with the user. ACCT indicates an account is specified, xxx is the 
account the named JOB is to be associated with. 


1 [,(ACCT,xxx)] 


SNAP[F1L£, fid] © 


Saves core (the monitor) on the specified file or to the SE op label by default. 


STAT tasknome[, (JOB, jobname)] 

. . .. 


Output the status of the specified job on OC. The "tasknome" defines the 
name of the task from which status information is desired. The "JOB" is a 
keyword that indicates that the job under which the task is running will be 
specified. (If "JOB" is not present, fobname is defaulted to the CP-R job. ) 
The "jobname" is the name of the job under which the task is running. The 
task status will have the format illustrated in Figure 5. 
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Tefal* 8. Standard Operator Key-h" (cent. ) 



Key—In 


Purpose 


(fid 
STDLB label, {device 
loplabel 


© 


Changes a current oplabel assignment. The new assignment will stay in effect 
until changed by another STDLB key-in or system is rebooted, "label" spec- 
ifies the oplabel to be assigned, which must have been previously assigned at 
SYSGEN. "Fid" specifies a disk file or disk area, "device" specifies a 
physical device name, or "0" for the null device, "oplabel" specifies one 
of the SYSGEN-defined oplabels. 


SYfjobname] © 


Overrides normal software disk file write protection for the specified job. 
The default for 'jobname' h 'BKG* which is the background job. The SY 
privilege is removed by the RSY key in or job termination. For background, 
it is also removed automatically when a IJOB or IF1N command is processed. 


TY © 


Transfer control from the C device to OC (typewriter) for reading control 
commends. 


W © 


Suspend current background fob and enter WAIT state. 


X © 


Abort current background job. Message on OC and LL will show last loca- 
tion executed. 


e 


Delete this line. (On a Xerox 550, the combination "CONTROL" and "X" 
may be substituted, ) 


© 


Ignore operator key-in request. 


4 


Delete last character. (On a Xerox 550, a "\" may be substituted. ) 



Table 9. Terminal Job Entry Key-ins 



Key- In 


Purpose 


CONTROL yyndd © 


Causes a control interrupt (equivalent of Yc) to take place for the named 
terminal job. It is used for jobs previously created by the LOGON key-in. 
Active terminal jobs will have been logged on OC as they become octive. 


LOGON TYndd © 


Causes device TYndd to be processed by the logon processor and so perform 
as a normal TJE user. 


OFF © 


Prevents any new on-line user from logging on. An OFF key-in and an ON 
key-in are equivalent. 


onH e 


4t* 
Specifies the number of on-line users allowed on the system at any one time. 

When n users are on, no additional users ore allowed to log on until a cur- 
rent user logs off. All makes all lines available. 


SEND^^me^ © 


Causes the text message to be sent to the TJE terminal specified by yyndd, 
or sent to all active terminal users if the ALL option is specified. 
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Table 10. Symbiont Key-Ins 



Key- In 


Purpose 


BATCH fid © 


Places the specified file on the symbiont input queue. If background control 
is in symbiont mode (see 'C key-in), background is started. A botch file 
may contain only one background job. 


DELETE idenf © 


Deletes symbiont files. All input and output symbiont files associated with 
the specified job ID will be deleted. If the specified job is still active, the 
DE LETE key in has no effect. 


DO0 


Sets a switch to cause the symbiont system to delete each one of o job's files 
from the OS area as soon as it has been output. When the DO key-in is in 
effect, the R and B options of the Syyndd key-in have the same effect as the 
C optbn. If DO has not been keyed in, the switch is set such that all a job's 
output files are deleted when its last file has been output. 


PRIORITY ident, priority O 


Changes the priority of a job in the symbiont area, where "ident" is the job 
ID and "priority" is the new priority to be associated with the specified job. 
Priorities are expressed as hexadecimal values from through 7, where 7 is 
the highest priority. A priority of inhibits selection of a job for execution 
in the IS area and prevents output from a job waiting in the OS area. 


RDO © 


Used in conjunction with the DO key-in and causes deletion of a job's files 
in the OS area to occur when the job's last file has been output. See DO 
key-in. 


SS © 


Initiates symbiont input when only one symbiont input device exists. The 
key-in is not allowed if more than one symbiont input device exists. If 
background control is in symbiont mode (see 'C key-in), each time symbiont 
input defines a new job, the symbiont insures that background is started. 


Syyndd, option © 


This symbiont key-in gives the operator control of the symbionts, where 
"yyndd" is the physical address of a symbiont device and "option" specifies 
the action to be taken and may be one of the following: 




I initiate symbiont I/O on the specified device. Output sym- 
bionts do not require this key-in as they ore self starting 
unless an "L" or "T" is in effect. 




S suspend symbiont activity for the specified device. 




C continue symbiont activity for a previously suspended device. 




B[,n] continue symbiont activity for a previously suspended device. 
Before the output is continued, the output file is backspaced n 
line printer pages. The default will be one line printer page 
(a line printer page is approximately 37 records). If the device 
is not a line printer or if the DO key-in is in effect, B has the 
same effect as C. 




R restart symbiont activity for a previously suspended device. 

Symbiont activity will start from the beginning as if it had not 
been suspended. If the DO key-in is in effect or if tfiis is on 
input symbiont, R has the same effect as C. " 




L lock out the symbiont from future activity after this file. After 
completing the current file, the symbiont terminates. An input 
symbiont will terminate when the next IJOB or IFIN card is 
read. An Syyndd, I key-in is required to restart symbiont activ- 
ity on the device. 
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Table 10. Symbiont Key-Ins <cont. ) 



Key-In 


Purpose 


Syyndd, option (eont.) 


T has th« tame effect as the "L" option except the device is re- 
moved from the symbiont pool if it was not dedicated to sym- 
bionhatSYSGEN. 

Q save the current output file and terminate. What remains of 
the file is returned to the output queue and the symbiont is 
locked immediately. The entire file is saved if the symbiont 
is not in DO mode. When the system assigns a new symbiont 
output device to the file, the output operation is continued 
from where it was stopped. Q is useful in moving a file from 
a down device to one that is working. 

X release the current fob file and begin processing the next job 
file. 

If background control is in symbiont mode (see C key-in), each time 
symbiont input defines a new job, the symbiont insures that background 
is starred. 



Table 11. Media Conversion Key-Ins 



Key-In 



Purpose 



MEDIA 



© 



Either to control the operation of the MEDIA task or to specify a MEDIA copy 
of an input source to an output destination, where control operations ore: 
I = initiate the MEDIA task or resume operation if it has been stopped. 
L = prevent the start of any new copy operations after the completion of the 
current operation. S - suspend the current operation. X ■ abort the current 
operation and do not post processing. 



MEDIA ( 



FILE, fid 



IN, 



(yjnddj 



,( 



SFIL£,n 

ALL 

DEL 

REW 

UNLOAD 



It • • • 



,( 



FILE, fid 

""■CM 



,( 



NVFC 1 




" 


SPACE, n 






ADD 






SFILE, n 


),. 


# . 


WEOF,n 






REW 






UNLOAD t 




. 







Copy operations request MEDIA to copy a file on a disk tope, or cards to an- 
other file, which may be on a disk, card punch, tape, printer, or, if the in- 
put is on a disk, a keyboard printer. One or more options may be given to 
specify pre- and post-processing of the input and output mediums, 

where 

SFILE, n skips a tape n files forward before the copy begins. 

ALL continues copying successive files until a double end-of-file is 
found. 

DEL deletes a disk file after the copy. 

HEW and UNLOAD rewinds (unloads) a tape after the copy. 

NVFC inhibits use of the first byte in each record as^ VFC byte in 
printed files. 

SPACE, n causes n lines to be skipped between each printed line 
when NVFC is given. 

ADD causes the input file(s) to be odded to the end of a tape already 
containing files. 

WEOF,n writes n EOTs on the output tape after the copy. 
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The disploy has the following format: 




PRI TASK TASK TASK JOB 


TASK TASK 


SEC NAME FRIO STAT NAME 


FWA LWA 


S CTRLTASK FEFE 10 CPR 


00000 03E4D 


S HKEXEC FFFF 20 CPR 


06000 1DFFF 


S KG FFFF 20 BKG 


06000 1DFFF 


P CTRLTASK FEFE 80 CPR 


00000 03E4D 


where 




P indicates a primary task. 




S Indicates a secondary task. 




TASK PRIO is the hexadecimol 


priority value 


associated with the task. 




TASK STAT is a representation of the task's 


status, as follows: 




80 - task is primary 




40 - task is rolled out 




20 - task is stopped 




10 - task is in execution 




08 - task is in initialization 




04 - task is suspended 




02 - task is time-sliced 




01 - task is swapped 




00 - task is executable 




FWA and LWA stand for first-word address and last-word 


address respectively. 





Figure 3. Display Format 



The analysis and subsequent action from an operator's 
key-in is performed at the Control Task priority level. If 
the operator key-in is not recognized as a valid input, the 
following message is output on the OC. 

1 1 KEY ERR 

In which case, the operator should retype the input cor- 
rectly. Note that if the typewriter is busy at the time of 
the Control Panel Interrupt (i.e., waiting for an input to 
complete), the operator must complete the input before the 
system will output the prompt character. 



COMBINED KEY-IMS 

To expedite operator key-ins, the following combinations 
of key-ins are recognized: 



Combined Form 

FGC 
SYC 

SFC,FSC 
TYC 



Result 

Execute FG and C key- ins. 
Execute SY and C key- ins. 
Execute FG,SY, and C key-ins. 
Execute TY and C key-ins. 



09:23 


OCT 25, 


•73 




YYMDD 


MDL# 


ACCESSES ERRORS ERR/ 1000 


TYA01 


7012 


76 





LPA02 


7445 


1037 





CRA03 


7140 


110 





CPA04 


7160 


13 





9TA80 


7322 


1760 





9TA81 


7322 








9TA82 


7322 


273 


6 21 


9TA83 


7322 








9TAD1 


7333 








9TAD2 


7333 








7TAE0 


7372 








7TAE1 


7372 








DPDF0 


7242 


25752 





DPDF1 


7242 








DPDF2 


7242 








DPDF3 


7242 








DPBE4 


7275 








DCBF0 


7212 








DCCF0 


7232 


1651 





DCCF1 


7232 








DCCF2 


7232 








6 


FILED LOGS 


LOGS 


LOST 


where 








YYNDD and MDL* correspond to parameters 




defined on 


the :DEV1CE control commands 




input at SYSGEN. 




ACCESSES 


is the number of SIOs issued for 




each job. 






ERRORS is 


the number of error retries and error 




completions for each device. 


ERR/1000 is the error rote computed as follows: 




ERR/1000 


= (ERRORS*1000)/ACaSSES if 




ACCESSES > 0. 






ERR/1000 


= if ACCESSES 


= 0. 


FILED LOGS 


is the total number of error log 




entries that have been successfully filed. 


LOGS LOST 


is the number 


of log entries lost 




because error log filing could not lake place. 



Figure 4. Error Summary Example 
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STATUS xxxxxxxxxxxxxx PRIORITY xxxx 

(binary) (hexadecimal) 


where binary 


status bits are as follows: 


Bits Value 


Meaning 

Task in final termination. 


1 


1 1 


Task connected to CAL2. 


2 1 


Task connected to CAL3. 


3 1 


Task connected to CAL4. 


4 1 


Background task. 


5 1 


Secondary task. 


6 1 


Task being aborted. 


7 


Task initiated via RUN. 




Task initiated via INIT. 


8 I 


Load to be performed. 


9 1 


Public Library used by primary tasks. 


10 1 


Public Library used by secondary 
tasks. 


11 1 


Release to be performed. 


12 1 


TEL control requested. 


13 1 


Task is loaded. 


14 1 


Task is run queued. 


15 I 


Break control requested. 


Hexadecimal priority characters are as follows: First 
two hexadecimal characters correspond to interrupt 
level minus X'4F'. For secondary tasks this is the 
level of the dispatcher for the task. Last two hexa- 
decimal characters are the software priority of a sec- 
ondary task, or zero for a primary task. 



DCVCE CONTROL 

If the system encounters on abnormal condition during 
an I/O operation, a pertinent message to the operator 
is output on the OC device. Such a message is of the 
form 



1 1 name message 



: 



where 



name is the physical device name, yyndd, or the 
disk file name. 



message is the message string informing the oper- 
ator of the specific condition that has been de- 
tected; for example : 



ERROR (error was detected on operation) 
MANUAL (device not ready) 



or 



VO messages are discussed below, grouped according to the 
type of device to which they apply. 



I/O K£Y-W FORMAT 

After correcting the abnormal conditions, the operator re- 
sponds by means of a key-in. The format for an I/O 
key-in is 

yyndd a © 



where 



Figure 5. Task Status Format 



yyndd is the physical device name of the device 
involved in the I/O operation. 

a is a single character that requests a system action 
relative to the device, as follows: 

C Continue "as is". 

E Inform the user program of the error and 
transmit record "as is". 

R Retry the I/O operation. 

X Abort the pending I/O. 
© is the NEW LINE code. 
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CMD HEADER NESSA6ES/KEY-MS 

If the card reader fails to read properly, or If a validity 
error occurs, one of the following messages is issued: 

! ICRndd ERROR 

1 ICRndd CARD NOT FED 

A FAULT indicates that the error condition occurred prior 
to any data being transferred; an ERROR indicates that at 
least one byte was read. After correcting the condition, 
the operator responds with an ]/0 key-in message. The 
action character selected depends on the circumstances 
causing the error condition. 

If a feed check error or a power failure occurs, CP-R out- 
puts one of the following messages (depending on where in 
the read cycle the error took place): 

I ICRndd ERROR 

I ICRndd CARD NOT FED 

I ICRndd TIMED OUT 

If the card in the hopper is damaged, the operator replaces 
it with a duplicate, presses the RESET burton on the card 
reader, and responds with one of the following key-ins: 

CRndd R © 

CRndd C © 

In the event of a power failure, the operator presses the 
RESET button on the card reader and responds with the 
key-in: 

CRndd R © 

If the card stacker is full, if the hopper is empty, or if the 
device is in the manual mode, the following message is 
issued: 

I ICRndd MANUAL 

The operator corrects the condition and then presses the 
START burton on the card reader. 



CARD PUNCH MESSAGES/KEY-WS 

Instead of outputting an error message when a punch error 
is first detected, the ^0 handler attempts to punch a card 
x times (x = NRT, a DCB parameter specified by the user) 
before the following message is issued: 

I ICPndd ERROR 

This message indicates that the card punch is not function- 
ing properly and the operator should reevaluate the job 



stock based on this knowledge. Improperly punched cards 
are routed to an alternate stacker. 



If the input hopper is empty, the stacker is full, or the chip 
box is full (some devices), or if the device is in the manual 
mode, the following message is issued: 

I ICPndd MANUAL 

The operator corrects the condition and presses the START 
button on the card punch. 

If a power failure or a feed check error occurs, the system 
outputs one of the following messages (depending on where 
in the cycle the error took place): 

! ICPndd ERROR 

I ICPndd TIMED OUT 

If the card in the hopper is damaged, the operator removes 
it, presses the RESET button on the card punch, and responds 
with the key-in 

CPnddR© 

In the event of a power failure, the operator presses the 
RESET burton on the card punch and responds with the 
key-in 

CPndd R © 



DISK PACK MESSAGES/KEY-INS 

If the operator enters the key-in 

DED DPndd,R © 

and there are no open files on the specified disk pack, 
CP-R outputs the message 

II1DLE 

If there is at least one open file on the specified disk pock 
at the time the DED key-in is performed, CP-R will output 
the message 

IIDPnddlDLE ^ 

when there is no longer an open file on the indicated disk 
pack. The operator may now remove the pack from the in- 
dicated unit, insert a different pack, and key in 

UND DPndd,R © 

to allow use of the new pack. 
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DISK DATA PMTf CTIOII 

Software protection of the data on disk storage is provided 
on disk file and area occesses. Areas with write protection 
code 'S' (system) may not normally be written by any user 
program. Areas with protection 'F' (foreground) can not 
normally be written by background programs. Disk area 
protection is specified when the area is defined by SYSGEN. 
Write protection does not normally apply to device-access 
disk operations, but this type of access is normally permitted 
only to foreground programs. All software restrictions on 
disk access may be overridden for a specified job (including 
BKG, the background job) by use of the S Y key-in. The 
message 

I lyyndd WRT RESTRICTED 



or 



I IPAUSE KEY-IN SY 

(if included in the background command stream) will be 
output on OC to inform the operator that access to a pro- 
tected disk area is requested. The operator would not nor- 
mally grant system privileges (key-in SY) unless he was 
assured that it was authorized for the requesting job. 



If the line printer power is off, the system outputs the 
following message: 

MLPnddUNRECOG 

If a printer went into test mode during an I/O operation, 
the following message is issued: 

I lyyndd TEST MODE 

The operator should correct the condition and respond with 
the key-in 

LPnddR ® 

If a printer became nonoperationol during an I/O operation, 
the following message is issued: 

1 lyyndd NOT-OPERATIONAL 

The operator should correct the condition and respond with 
the key-in: 

I lyyndd R © 



LINE PRINTER MESSAGES/KEY INS 



MAGNETIC TAPE MESSAGES/KEY IRS 



When an irrecoverable print error is detected, the system 
outputs the following message: 

IILPnddERROR 



If an error occurs during the reading or writing of magnetic 
tape, the I/O handler attempts a recovery x times (x = NRT, 
a DCB variable). If the error is irrecoverable, the user is 
informed via an error return . 



The I/O handler attempts to print a line x times (x = NRT, 
a DCB variable specified by the user) before outputting the 
above message. The operator's response after correcting the 
condition depends on the specific device and circumstances. 

If the printer is out of paper, if the carriage Is inoperative, 
or if the device is in the manual mode or off, the following 
message is issued: 

I ILPndd MANUAL 

The operator corrects the condition and presses the START 
burton on the line printer. 



If a tape unit is addressed and there is no tape mounted or 
power is off, the following message is issued: 



I ITTndd UNRECOGNIZED 



If an attempt is made to write on a tape unit without a write- 
permit ring, the following message is issued: 



I ITTndd WRITE PROTECTED 



The operator's key-in response depends on the circumstances. 
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4. INPUT/OUTPUT OPERATIONS 



The CP-R I/O system provides the user with the capability 
of performing input/output operations on standard Xerox 
peripheral devices. An I/O request is made through execu- 
tion of a CAL1 instruction that addresses a Function Param- 
eter Table (FPT), which in turn is a list of parameters that 
define the request. The FPT addresses a Data Control Block 
(DCB), which is a list of parameters that define the nature 
of the data file. The DCB then addresses a Device Control 
Table (DCT) entry or a RAD File Table (RFT) entry, depen- 
ding upon whether the data file concerned is associated 
with a peripheral device or with a disk file. The DCT entry 
contains the device status parameters and the RFT entry 
contains the disk file parameters. 

The CAL1 instruction and FPT must be generated at assembly 
or compilation time. Symbol, Macro-Symbol, or A P users 
must include both the CAL1 and the FPT in the source code. 
For FORTRAN users, the compiler generates the necessary 
CALlsandFPTs. 

For users of the Xerox A P processor, a set of high-level I/O 
procedures is provided. These procedures translate, at as- 
sembly time, to the requisite CAL1 instructions and appro- 
priate FPTs (via assembly-system CPR). The procedure calls 
for I/O ond other types of system services are described in 
Appendix A. 

All DCBs are given names beginning with M: for system 
DCBs orF: for user DCBs. The DCBs may be included in the 
source code if desired. If not included, the Overlay Loader 
generates the DCBs necessary to satisfy any unsatisfied ref- 
erences to F: or M: DCB names. System DCBs generated by 
the Loader have default parameters; user DCBs generated by 
the Loader are left blank. 

The correspondence between a DCBand a device or file can 
be established by using the 1 ASSIGN control command or 
ASSIGN service function. Other DCB parameters describ- 
ing the data file may also be set by the I ASSIGN control 
command or by the DEVICE/FILE Mode service function. 

Two types of Read/Write requests are provided. Type I re- 
quests have the completion status posted in the DCB. The 
disadvantage of this type of I/O operation is that a DCB 
cannot be shared among requests in different tasks because, 
in general, it is impossible to associate the completion status 
in the DCB with a specific request. For this reason TYPE II 
requests are provided. 

Type II requests result in the completion status being posted 
in the FPT associated with the request. This enables several 
requests (perhaps in several tasks) to be in progress simulta- 
neously on a given DCB. Type II requests require that the 
associated FPT must be in memory and not in a register. 

The CHECK function tests for the completion of READ/ 
WRITE requests that are performed without waiting for com- 
pletion. In no-wait requests, the CHECK function must be 



used to cause the DCB or FPT to be posted with the completion 
code and actual record size. 



PERMANENT FILES 

Permanent files are defined through RAD ED IT by use of the 
:ALLOT command or through the ALLOT service call. Data 
can be entered through RADEDIT or any program that uses 
the system I/O. At definition time, the following file 
parameters are given by the user: 

File name (maximum eight characters). 

Disk area (optional). 

Disk file account (optional). 

File organization (blocked, unblocked, compressed). 

Record size (for blocked or unblocked files to be 
accessed sequentially). 

Granule size (for files to be accessed directly). 

File size. 

In systems which do not include the disk file account option, 
the user must specify the area name on all disk file refer- 
ences, but may not use an account name. In systems which 
include the option, either the disk area name or the disk file 
account name or both may be omitted and defaults will be 
provided. In most cases, if an account name but not an area 
name is specified, the file will be defined/found in one of 
the public areas on the system (at least one of which must 
have been defined by SYS GEN, in order to support this de- 
fault). If an area name is specified, but not an account 
name, the system account name is the default. If neither 
area nor account name is specified, the defaults are the 
account of the user and one of the public areas. These de- 
faults allow several ways to chose between simplicity and 
detailed control in dealing with the disk file data base. 

TEMPORARY FILES 

Temporary files are in the Background Temp area and have 
the fixed names X; (1 < i <9), GO and OV. The size for 
these files can be set by using the IALLOBT control com- 
mand. If no IALLOBT control command appears within a 
user job, the files assume default sizes that are set by the 
Job Control Processor. The files X; should be considered as 
primarily for temporary use within a single job step, since 
they ore all allocated from a single area with X- + j be- 
ginning just above X;. Therefore, changing the site of a fife 
X; can cause a change in location of files X] for j > i. GO 
and OVare allocated from the top of the temporary file area 
downward. A change in the size of files X; therefore has no 
effect on the position of these files on the disk. 

Since the size and location of temporary files can be changed 
through background job control commands, they must not be 
used by foreground programs. 
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FILE ORGANIZATION 

•LOCKED FILES 

Blocked files contain fixed length records whose length is 
less than or equal to 128 words. In blocked files, the largest 
possible integral number of records is combined into 256-word 
blocks. These blocks are basic units of data transmitted to 
and from the disk. As sequential READ requests are mode to 
a blocked disk file, the blocks are read from the disk into 
blocking buffers as necessary, and the data records are 
transmitted to the user's input buffer. 

Blocked organization is specified for a file when the file 
is defined. A file specified by the user as blocked, but 
having a record size greater than 12B words, will be given 
unblocked organization. 



UNBLOCKED FILES 

Unblocked files contain fixed length records. Each record 
begins on a sector boundary and requires some integral 
number of sectors that is the smallest possible integral num- 
ber that can contain the record. 



The user is not restricted to I/O operations whose length is 
less than or equal to the granule size. For requests of 
length greater than granule size, the I/O system transfers 
the requested number of bytes to or from the disk starting 
with the granule specified. An entire area may be treated 
as a single direct access file by using a file name of 0. 



DEVICE ACCESS 

In the device access method, the user reads or writes through 
a DCB which is assigned directly to a disk as a device. 
The assignment may be done with a standard ASSIGN com- 
mand or with the DEVICE Set Index function. The "key" 
parameter, which must be present in the READ/WRITE FPT, 
is treated as a sector number which is relative to the abso- 
lute start of the disk. This method allows direct (random) 
access to any sector on the disk (except the flawed track 
pool). All other parameters In the READ/WRITE FPT ore 
treated as they would be for any READ/WRITE call . 

In this method, the disk may have areas defined on it, but 
having areas is not a requirement. Note that no error 
checking is provided which would prevent users of this method 
from interfering with other users who may be accessing the 
disk. 



COMPRESSED FILES 

Since many blanks occur in typical programming -language 
source code compression of EBCDIC data in disk files is 
accomplished by the removal of blank characters. Com- 
pressed files are blocked into 256 word blocks on the disk 
and the records are of variable length. No record crosses 
a block boundary. Special codes, imbedded in the com- 
pressed records, allow for proper decompression. 



DISK ACCESS METHODS 

SEQUENTIAL ACCESS 

The sequential access method provides record-by-record 
access to the file in the same way that a data file on mag- 
netic tape is accessed. A sequential access READ/WRITE 
request results in the next record in sequence being read or 
written. Sequential access can be used on blocked, un- 
blocked, or compressed files. 

DIRECT ACCESS 

In the direct access method, the user furnishes the relative 
granule number of the start of the READ/rVRITE request and 
the number of bytes to be transferred. The user is respon- 
sible for the organization of the file, including discrimina- 
tion of logical records, maintenance of a key structure within 
the file, etc. Addressing files by granules allows the direct 
access method to be independent of the disk sector size. 
Granule size is specified by the user at file creation. Each 
granule begins on a sector boundary. 



DISK PACK FILES 

Although files on disk packs ore logically and functionally 
identical to files on fixed-head disks, the physical char- 
acteristics of disk packs require that the I/O be treated 
differently in certain cases. 

Initially, all transfers to or from a disk pack file are at- 
tempted as one complete I/O operation. If the hardware 
signals that the transfer encountered a flawed track, then the 
single I/O transfer will be broken into several I/O transfers. 
Each of these will be confined to no more than one track, 
thus al lowing processing of alternate tracks for flawed- tracks. 
All such data transfers will be treated as fellows: 

1. The byte count will be truncated to end on the first 
track boundary. 

2. The data transfer to the track boundary will be done 
and any flawed-track processing will be performed. 

3. If the residue of the operation does not cross another 
track boundary, the operation will be completed as 
originally requested; otherwise, steps 1 and 2 will be 
repeated until the residue does not cause transfer over 
a track boundary. 

4. If a flawed track Is encountered? th« <*kk pack error- 
recovery routine will read the header of the flawed 
track to determine its alternate. The data transfer will 
then be performed with the assigned alternate track. 

If the initial transfer encounters a cylinder boundary, 
the I/O request is modified to account for the data 
already transferred and the I/O operation is continued 
on the next cylinder. 
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EXTEKSIBLE FILES 

When o permanent disk file it ALLOTed at extensible (see 
ALLOT call and :ALLOT RADEDIT command), an extension 
to the fife will be automatical!/ allocated when on end- 
of-file condition h detected during a WRITE operation to 
the file. The WRITE request resumes using the new extent. 

The extents will have the size specified when the file was 
ALLOTed with one exception. A direct access WRITE to 
an extensible file will cause an extent to be allocated 
which is large enough to contain the record but no smaller 
than the specified extent size. The user may request, how- 
ever, that the extents be limited to the specified extent 
size by use of the FIX option on the -.ALLOT RADEDIT com- 
mand or by setting the F5 parameter in the ALLOT CAL. 

If an end-of-data (EOD) is detected when reading an ex- 
tensible file, a switch to the next extent in sequence occurs 
and the READ continues using the newly selected extent. 

When a READ/WRITE is requested with no-wait, intermediate 
file selection or allocation is done with wait. However, 
the actual reading or writing of the data record is done with- 
out waiting. 



I/O QUEUEING 

The I/O system provides for queueing of all requests to I/O 
devices. That is, any I/O request (READ, WRITE, REW, 
IOEX, etc.) requiring a device to be accessed results in the 
request for the specific access being queued - 

Device requests are queued on a controller basis (one queue 
per controller), and they are queued in order by priority of 
the task making the request. For example, a READ request 
to a card reoder will be placed in the queue for the speci- 
fied card reader controller, and its position in the queue is 
determined by the priority of the requesting task and the 
relative priorities of the requests already in the queue. Re- 
quests for a designated device from a specified priority level 
are queued by order of occurrence. The queues are chains 
of entries representing requests for actual I/O operations on 
devices. There is a single pool of free entries for all de- 
vices, and these entries are removed from the pool and I inked 
to the controller queues as needed. The queue entry is re- 
turned to the free entry pool when a queued request is 
completed. 

By using assembly options, the system may include queuing 
routines that optimize I/O transfers to disk packs and fixed- 
head disks. In the case of disk packs, the optimization 
minimizes arm motion when there are more than two requests 
in the queue. In the case of fixed-head disks, the optim- 
ization minimizes rotational latency when there are more 
than two requests in the queue. 

At System Generation, the user may specify the maximum 
number of entries to be used for background requests to 
ensure that the background does not tie up all the queue 



entries, thus causing foreground requests to wait. Whenever 
a request is made and the free entry pool is empty (al I queue 
entries in use), the request is made to wait until an entry is 
freed. 



I/O CLEANUP AND I/O START 

I/O Cleanup is the data processing performed between com- 
pletion of the actual data transmission (signaled by occur- 
rence of the I/O interrupt) and the completion of the request. 
It includes such functions as error testing, setup for error 
recovery, posting of completion status in the ECB, setting 
of indicators in the DCT, dequeuing the completed request, 
etc. 

I/O Start is the operation of starting a device for the next 
request. 

Under the CP-R I/O system, CPU time may be taken from a 
task to perform data processing for lower priority tasks. I/O 
Cleanup and I/O Start functions are performed at the vari- 
ous times and priority levels given below: 

Depending upon SYSGEN options, ]/0 Cleanup may be 
done in one of three ways: 

1. I/O Cleanup may be done at the I/O interrupt level. 
This assures fast I/O service but may delay service to 
real-time tasks that are connected below the I/O inter- 
rupt level. 

2. I/O Cleanup may be deferred to a specified external 
interrupt level. This allows fast response to real-time 
tasks running at levels higher than the deferred level 
yet, giving maximum I/O service to lower priority tasks. 

3. I/OCIeanup maybedeferred to user orCP-R dispatcher 
levels at all times. In this case, I/O Cleanup is done 
upon: 

a. Entry to any CP-R dispatcher (all channels), 

b. For any I/O service performed with WAIT (only for 
requested channel), or 

c. For any I/O Start request (only for requested 

channel). 

I/O Start is done either at the time the I/O request is made 
or following I/O Cleanup when there are still I/O requests 
pending for that channel. * 



SHARING DCBs AMONG TASKS 

DCBs can be shared among several primary tasks within a 
given load module subject to the restriction that no task can 
make a Type I request on a DCB that is busy with another 
Type I request. 
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DCBs explicitly referenced by the user are allocated and 
created by the titer either in the source code (for assembly 
language), the compiler, or the Overlay Loader. This 
means that each program has a private copy of all DCBs 
explicitly referenced, and no DCBs are shared among pro- 
grcms. The user program has the responsibility for coordinat- 
ing the Open and Close functions for DCBs shared among 
primary tasks within a program. An Open request results in 
the DCB being opened if it is not already open. A Close 
request causes the DCB to be closed if it is not already 
closed. No attempt is made to balance Open and Close 
requests for a DCB to determine which Close request should 
actually cause the DCB to be closed. 



SHARING I/O DEVICES AMONG TASKS 

Any number of tasks within a given program can share any 
device by sharing a DCB assigned to the given device. For 
sequential type devices (i.e., card reader, card punch, 
line printer, magnetic rape, responsibility for positioning 
and/or determining the position of the device is left Id the 
user. No attempt is mode to analyze a request on a DCB to 
determine which task has made the request. 

Sequential output devices (i.e., cord punch, line printer, 
mognetic tape), can be shared by tasks (possibly in different 
programs) that use different DCBs. The sharing of output 
devices by different programs using different DCBs could be 
used for logging error conditions or alarms. 

Sharing of sequential input devices (i.e. , card reader, mag- 
netic tape)shouldbe accomplished through real-time requests 
on a single DCB. For example, a background user who 
wishes to use double buffering on a card reader can do so by 
using two real-time Read requests with two different FPTs. 

Random access devices such as disks can be shared, using 
direct access, by tasks within different programs using vari- 
ous OCBs. The sharing can be performed without restriction 
other than those restrictions normally imposed on tasks 
sharing a DCB. 

As DCBs are opened and closed, a count of the DCBs that are 
open and assigned to a device is kept. This count is incre- 
mented for every open request on a DCB assigned to the par- 
ticular device, and is decremented for each Close request. 



I SHARING DISK FILES AMONG TASKS AND JOBS 

I Any number of primary tasks within a load module can share 
a disk file by sharing a DCB assigned to the file (subject to 
the conditions placed on tasks sharing DCBs discussed pre- 
viously). A disk file shared in this manner can be accessed 
either sequentially or directly. Input/output requests are 
allowed. 

<^n/ number of primary tasks within a lood module and any 
number of load modules within a job can share a disk file 
using different DCBs with the restriction that no sequential 
input requests can be allowed on a file shared in this manner. 
A count of the number of DCBs opened and assigned to a disk 



file is kept for each file. If the count is greater than 1, no 
sequential Input from the file is allowed. The user programs 
have the responsibility of coordinating accesses to disk files 
shared in this manner. 

£jsk files can be shared by tasks in different jobs if certain 
procedures are followed. The file is made sharable by 
assigning on operational label to the file using the STDLB 
key-in. Executing a STDLB call from a task running in the 
CP-R job will accomplish the same thing. The file should 
not have been open at the time of the STDLB request. Each 
active job will now have the operational label assigned to 
the file (if the operational label assignment was not pre- 
viously changed). Access to the file is done through a DCB 
assigned to the operational label. Access will be dented to 
a blocked or compressed format file which currently has a 
blocking buffer tied to it if it is determined that the block- 
ing buffer is not in the caller's context. The restrictions that 
apply to the sharing of a file within a job also apply to the 
sharing of a file by tasks in different jobs. 

An Open request on a DCB assigned to a disk file results in 
opening of the file if it is not already open. A Close request 
on such a DCB results in closing of the file only if the "Open 
DCB Count" for the file is 1 and no operational labels in any 
job are assigned to the file. 



I/O END ACTION 

Primary tasks may use I/O end-action. Three types of end- 
action are possible. 

1. The user provides an end-action address in the FPT. A 
transfer to this address will be made following the 
occurrence of an I/O interrupt that signals completion 
of the data transfer. This end-action transfer is mode 
by executing. 

BAL, 1 1 end -act ion address 

with the CPU in master mode, the I/O cleanup level 
active, and registers 5 through 9 loaded as follows: 

5 AlO status 

6 Upper ha If word of TIO status, right- 
justified in register 

7 Device type (DOT) index 
8,9 T DV status (doubl eword) 

Return from the end-action routine must be made by 

B *n 

It should be noted that since end-action may be per- 
formed with the I/O cleanup level high, all tasks whose 
priority is lower than that of the I/O cleanup level are 
effectively disabled for the duration of the end-action. 
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Since the end-action user can seriously degrade interrupt 
response for lower priority tasks, it h strongly recom- 
mended that this type of end-action not be used for 
applications where other techniques are satisfactory. 

The user FPT contains either an interrupt number or 
interrupt label specifying a system interrupt. The sys- 
tem interrupt is triggered upon occurrence of an I/O 
interrupt that signals completion of the request (this 
interrupt will be triggered before the I/O interrupt is 
cleared). The task connected with the specified inter- 
rupt then performs the end-action function at the proper 
priority level. The user is responsible for connecting 
the interrupt and ensuring that it is armed and enabled. 

The I/O system sets a flag in the TCB to indicate that 
the trigger has been performed. The EXIT routine 
interrogates this flag before performing the EXIT for 
centrally connected tasks. If the flag is set, the occur 
rence of the interrupt (previously lost by the triggering 
of an active interrupt) wi 1 1 be simulated. If more than 
one I/O interrupt can occur while a task is active (or 
prior to such a task becoming active), the user is re- 
sponsible for checking all possible devices from which 
an interrupt may have occurred. (The flag bit in the 
TCB indicates one or more interrupt attempts.) Directly 
connected tasks using this type of end-action must as- 
sume the responsibility for solving problems of this type 
since there is no TCB in which a flag bit can be set. 



no I/O allowed) for each device. A* devices arc reserved, 
the proper count is incremented; and as they are released, 
the count it decremented. A value greater than zero indi- 
cates that the device is reserved. The user must balance 
each STOPIO request with a STARTIO request so the system 
can maintain order. 

When I/O requests are received by the system, the requests 
will be queued- Any request queued but currently not al- 
lowed will not be started. 

The foreground user can specify in a STOPIO request that 
the in-process operation on the specified device be aborted 
through execution of an HIO. 



DEVICE PREEMPTION 

A user may preempt a device (receive I/O interrupt control) 
with the STOP ALL SYSTEM I/O or DEACTIVATE I/O sys- 
tem calls by specifying the end-action parameter on the 
call. All succeeding I/O interrupts cause the specified 
end-action to occur. A device may also be preempted by 
dedicating it to IOEX at SYSGEN or by use of DEDICATE 
yyndd, X key-in. Note that in the latter two cases, the 
monitor handles the interrupt. 



The user FPT contains the address of a location to con- 
tain the AlO status following the occurrence of an I/O 
interrupt. The user should initialize the signal loca- 
tion to zero before executing the I/O call. This type 
of end-action is useful when multiple-device I/O oper- 
ations are being performed and the slower I/O is 
controlled by end-action types 1 and 2. 

Note that no end-action is taken for requests on a 
blocked or compressed disk file. 



RESERVING I/O DEVICES FOR FOREGROUND USE 

I/O devices con be reserved for exclusive use of the fore- 
ground program system through SYSGEN input, operator 
key-in, or through a system call from a foreground program. 
Reservation can be made either for a specific device, for 
all devices on a controller, or for all devices associated 
with a given IOP. When a device is reserved, it is speci- 
fied that either all foreground requests will be allowed or 
no requests will be allowed. 



DIRECT I/O EXECUTION (IOEX) 

CP-R provides primary tasks with the capability of pro- 
gramming I/O devices by executing TIO, TDV, HIO, 
and SIO instructions with user supplied IOP command 
doublewords. 



An SIO request will be placed in the I/O queue if the 
specified device is not preempted. At return from the call, 
the condition codes and status are set to simulate a success- 
ful SIO instruction. True hardware status for the I/O re- 
quest may be obtained by the user by specifying BAL type 
end-action on the SIO request. If the SIO request cannot 
be queued for any reason, the condition codes and status 
are set to simulate an SIO failure. Note that queued IOEX 
requests must cause only one I/O interrupt to occur during 
the execution of the channel program. 

If the device was preempted at the time of the request, the 
SIO instruction is executed and true hardware status and 
condition codes are returned to the user. If end-action is 
specified on the request, device preemption end-action is 
overridden. . 



Device reservation results in all background requests to the 
device being held in abeyance until the device is released 
for background use. The background user program is un- 
aware that execution is suspended. 

A count is kept of the number of reservations (STOPIO re- 
quests) of each type (either all foreground I/O allowed or 



An HIO request will use monitor routines to stop I/O activity 
on the device if it is not preempted. At return from the 
call, the condition codes and status are set to simulate a 
successful HIO instruction. If the device was preempted 
at the time of the request, the HIO instruction is executed 
and true hardware status and condition codes are returned 
to the user: 
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TIO and TDV instructions are always executed and true 
hardware status and condition codes are returned to the 



user. 



logical device requests are not subject to I/O timeouts. If 
desired, the user ma/ supply a time interval parameter on 
the service request (P13). This will cancel the request after 
the specified time period and post a FPT error code of X'67". 



KEYBOARD-PRWTER EDITED I/O 

Data transfers involving a keyboard-printer (TYndd) are 
normally subject to editing. On output, this means that 
each record is automatically followed by a and ©, and 
if VFC is set, the first character of the line is omitted. On 
input, editing is more complicated. First, before the input 
is requested, a prompt character is output. The prompt char- 
acter is obtained from the Job Control Block (JCB) of the 
calling task's job, unless it is specified in the READ call. 
When the record has been read, it is scanned. Each time 
a V" *s encountered, it and the prior character are deleted. 
If the record ends with an EOM, it is discarded and reread. 
Trailing carriage returns or line feeds ore deleted, and the 
record is extended with blanks to the requested byte length. 

The prompt character in the JC6 defaults to no prompt. It 
can be reset using the PC (Prompt Character) service call. 

Editing is suppressed by setting the DRC flag in the DCB. 



OPERATDNAL LABELS 

Operational labels are used to lend flexibility in the assign- 
ment of DCBs to peripheral devices. Operational labels are 
logical I/O media whose relation to a device or file can be 
controlled at several levels. 



Operational labels are assigned to devices or disk files. 
Each operational label has a permanent assignment and an 
assignment in each active job. When a job is created, its 
operational label table is derived from the permanent oper- 
ational label table. Assignment of operational labels to 
devices or disk files is mode in the following ways. 

1. At System Generation, permanent assignments are made 
and remain in force until changed through STOLB key-in. 
The originol system assignments ore reinstated whenever 
the system is again booted and initialized. 



LOGICAL DEVICES 

Provision is mode in SYSGEN to include logical devices. 
These are pseudo-devices which form a logical connection 
between read and write or write file markl/O requests. They 
are SYSGE Ned as if they were real devices (including ficti- 
tious device addresses), and may be used as any other I/O 
devices. 

Read and write requests are entered into the I/O queue nor- 
mally. When the logical device finds a match between a 
read and a write request, the data transfer is made directly 
from the write buffer to the read buffer. Requests are handled 
on a first in, first out basis within priority and otherwise in 
order by priority. Actual record sizes are posted as usual. 
Write file mark requests result in an EOF TYC and ab- 
normal code being posted for the read request. 

Logical devices supply the capability of communicating be- 
tween tasks via normal read/write services. It also provides 
the capability of intercepting or monitoring o data stream. 

The user should be aware that I/O buffers are locked in main 
memory during any I/O operation, and that where very large 
buffers or very many outstanding I/O requests are used, this 
may result in a deadlock. This is particularly true of logical 
device requests which must be satisfied by another I/O re- 
quest and not by independent action by a peripheral. Simi- 
larly I/O queue requests may be tied up and result in a 
deadlock condition. 



2. TheSTDLBkey-in can be used by the operator to change 
the system assignment of an operational label, which 
will result in a corresponding change in the operational 
label table for each active job, unless the assignment 
was previously changed within the job with a STDLB call. 

3. The ISTDLB control command can be inserted by the 
user to change the assignment of an operational label 
in the current background job. This change is in effect 
until the next IJOB command is encountered. 

4. The STDLB service call may be used to change the as- 
signment of an operational label in the user's job. Op- 
erational label assignments in other jobs are not affected 
unless the call originated from the CP-R job. In this 
case, the call has the same effect as an STDLB key-in. 

At System Generation, the user may specify any number of 
optional operational labels with the provision that the op- 
tional labels be two characters in length. An entry is built 
in the operational label table tor each optional oplabel, 
and each entry requires four bytes of system residence. 



DATA CONTROL BLOCKS (DCBs) 

DCB CREATION 

The Overlay Loader creates the DCBs for FORTRAN programs 
thatreference the standard FORTRAN operational labels 101 
through 106, and 108 for their 1/Orequests. For other labels, 
the user must create DCBs using I ASSIGN control commands 
and machine language subroutines. 



Keyboard-Printer Edited I/O/logical Devices/Operational Labels/Data Control Blocks (DCBs) 49 



DCfc far assembly language programs or* allocated and 
defined in the following ways: 



liter Creoted DCBs: The user may create his DCBs in 
the lource code. The parameters defined at source time 
may be overridden by (ASSIGN control commands if 
the user follows the convention of defining the name of 
a DCB and beginning the name with F:. 



Warning : DCBs will not receive any memory protec- 
tion, and assembly language users should exercise ex- 
treme care to prevent accidental alteration. 



loader Created DCBs: At the conclusion of the object 
module load and the library search and load, the loader 
creates DCBs for any unsatisfied RE Fs beginning with M: 
or F:. For REFs to system DCBs, defined in Table 12, a 
copy of the standard DCB is included in the root portion 
of the load module. This DCB contains standard system 
parameters, including standard assignment to a system 
operational label. For example, M:LO is assigned to 
operational label LO. User DCBs (F:) ore included in 
the load module but their parameters are left blank. The 
background user must define the parameters for F; DCBs 
through Overlay looder control commands at load time 
or IASSIGN at run-time. Definition and assignment of 
F:DCBs in foreground programs should be mode through 
Overlay Looder control commands. 



IASSIGN Command Created DCBs: (ASSIGN control 
commands con create DCBs in addition to defining or 
redefining parameters in existing DCBs. This OCB crea- 
tion facility enables FORTRAN IV and FORTRAN IV-H 
programs to perform I/O using variables as operational 
labels- At run-time, the FORT RAN program evaluates 
such variables, converts the variable value to a DCB 
name and locates the DCB. For example, a FORTRAN 
variable with value 101 would result in an I/O oper- 
ation using DCB F; 101. The DCB must have been creo- 
ted in an assembly language subroutine or through on 
IASSIGN control command. 



Table 12. System DCBs 



OCB ASSIGNMENT 

Most of the fields of a DCB can be modified at any stage in 
the creation and use of a program. Values may be assembled 
into user-created DCBs. They can be modified when the 
program is linked, using the Overlay Loader ASSIGN com- 
mand. For background programs, DCBs may be altered by 
the JCP IASSIGN command when the program is loaded for 
execution. During execution, DCBs may be changed by 
Device Mode services. Those fields not subject to these 
means of modification are maintained by the monitor, and 
should not be changed by user code. 



DCB Name 


Op Label or Disk 
File Assignment 


Comments 


M:C 


C 


The first 12 DCBs 


M:OC 
M:LO 


OC 
LO 


ore assigned to 
the standard op- 
erational labels. 


M.LL 


LL 






M:DO 


DO 






M.-CO 


CO 






M:BO 


BO 






M:CI 


CI 






M:SI 


SI 






M.-BI 


BI 






M:SO 


SO 


* 




M.-PL 
M:Xi(l<i<9) 


PL 
Xi.BT 


1 


DCBs for Back- 
ground Temp 
scratch file. 


M.-GO 


GO.BT 


DCB to write on 
GO file. 


M:OV 


OV.BT 


Output DCB for 
Overlay Loader. 


M:SL f 


Appropriate 
program file 


Input DC B for 
Segment Looder. 


The M:SL DCB does not have to be referenced by a 
program using overlays, since this DCB is automati- 
cally furnished by the Overlay Loader for any program 
with overlay segments. 



OCB FORMAT 

The format for a Data Control Block is given below: 
wordO 



TTL 



0-0 



— 



ASN 



word I 





NRT 






D 
t 

V 

r 


L 


TYPE 


DfV/OFlt/tfllF 






J"l 


J ii. i • 




111 u IJ 1. 13 


u 


i> 


1* mIjo HUtl 


J. i 1: ^l-.t ?» j: )' 



word 2 










'* 1 i ll. ' 


— 

r-j-rl 


TYC 


BUF 

ul mU t*l*S ii ii Jjli. it » rit ;> x r 



word 3 






RSZ 


ERA 


4 i » jl. 


i . 7I| . 10 HI 1? IJ 1. 


«li» I? » rtlje >i ii ti'u a i» ttltt 1* t )' 
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word 4 



ARS 



ABA 



o i » i t i i t > l t I <i liU u m itlit i7 it tt l teii B M l fc fa 1» glhH 16 1 



word 5 (optional) 






NO 

( 1 i 1 1« i" « T 


Nl 

• T IS III 12 I] M IS 


N2 

it i> >• rtljft li IS H 


N3 

mrx, hi» » u ii 



word 6 (optional) 



N4 



N5 



N6 



N7 



« I > ) U i t ill » K> lllu 12 u lilki 1; II Ifljo 21 JJ 2j]» JJ » rljt 2» JO 2 

word 7 (optional) 



'j'jO- 



nVili u iln 11 il l w 1 3 i i i ; l it 1? 1 1 w i g ii h a m h v g| » w n 3) 
(optional) 



AREA 



( I 2 J I J i « J li I It lilii n u ii ! I* iJ II I»IH 21 5) Jil!< Ji'k BlH H U i 

(optional) 



AO 



Al 



A2 



A3 



t I 2 i l . s « ? l l ♦ it n l i; il u li f w 17 it rf l lii ti K H i t. b 1. » l a* H M ' n ' 
(optional) 



A4 



A5 



A6 



A7 



6 I } J l< i i Ml ♦ » llll} II U ull* 12 II »l8 21 12 &1» U » PIS It > H 



where 



WordO 

TTL specifies the total length set aside for the DCB. 
It must be five or greater (although there is cur- 
rently noway to me any space past eleven words). 
It need not all be used. 

TTL should be set when the DCB space is reserved. 
No system services modify it. 

OPEN is the DCB open indicator. It must be set to 
zero before the DCB is opened. The I/O system 
sets the indicator to 1 when the DCB is opened. 

MOD is the mode flag (0 for EBCDIC mode; 1 for 
binary). This flag has meaning only for I/O re- 
quests to COC lines, 7-track magnetic tape, card 
punch, or card reader. For requests to read a card 
reader, Mode flog causes a Read Automatic. * 
Input from a card reader designated as theC device 
is always performed in automatic mode (mode flag 
is ignored). For COC lines MOD = l and DRC = 1 
implies transparency (no EBCDIC conversion, no 
N/L, or other line or timing control characters). 



See Chapter 3, Xerox Sigma Card Reader (Models 7120/ 
7122/7140)/Reference Manual, 90 09 70. 



BUSY is the DCB busy indicator that is set and main- 
rained by the I/O system to indicate that a Type I 
request using the DCB is in progress. Any Type I 
request using a DCB that is made when the DCB is 
busy will result in an error. 

ASC is the indication of ASCII mode tape operation 
for magnetic tape drives having program-controlled 
ASCII translation (0 indicates no translation; 1 in- 
dicates translation). This flag is ignored for other 
devices. 

DRC is the indication of direct record control for 
keyboard-printer operation (0 indicates edited rec- 
ord transfers; 1 indicates direct record transfers). 
Keyboard/printer edited transfers are described 
earilier in this chapter. For transfers involving 
other devices, the flag is ignored. (See MOD de- 
scription for COC line transparency. ) 

1 

D/P indicates packed binary mode for 7-track tapes 
in conjunction with MOD (above) being set (0 in- 
dicates unpacked; 1 indicates packed if MOD is 
also I). It also is used to indicate density selec- 
tion on a write at load-point to a magnetic tape 
drive with program-controlled density (0 indicates 
800 bpi; I indicates 1600 bpi). On other devices 
or under other circumstances than described, the 
flag is ignored. 

VFC is the vertical format indicator (0 indicates no 
format control; 1 indicates format control) specify- 
ing whether or not the first character of an output 
record is to be used to control vertical positioning 
for output to a line printer or keyboard/printer. 
Under format control, the line printer is given a 
"print with format" order. The keyboard/printer 
performs a preliminary new line (regardless of the 
format character)and outputs the record beginning 
with the second byte. The first byte is output as 
data on all other devices. VFC has no effect on 
other I/O operations. The format control codes are 
itemized in Table 13. 

DAN indicates whether a disk area name is provided. 
If ASN is not 1, DAN is not used. If ASN = 1 and 
DAN=0, the disk area index will be obtained from 
the TYPE field. If ASN = 1, DAN = 1, and PI =0, 
the disk area is unspecified (OPEN may provide a 
default). If ASN = 1, DAN = 1, and PI = 1, the 
area name will be obtained from the AREA field. 

DON indicates whether a device oroperational label 
name is provided. If ASN is not 3, DON is nol 
used. If ASN = 3 and DON = 0, the device or 
operational label index will be obtained from the 
DEV/OPLB/RFILE field. If ASN = 3 and DON =1, 
the device or operational label name will be ob- 
tained from the N0-N7 fields, a described later. 

BTD is the byte displacement specifying at which 
byte (0-3) in a buffer the data begins. 
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ASN it the assignment type indicator (0 means null; 
1 means disk file; 2 means not used; 3 means de- 
vice or system operational label). 

Table 13. Line Printer format Control Codes 



Value 



Device 



Code 




(hexadecimal) 


Action 


CO, 40 


Space no additional lines. 


60, E0 


Inhibit space after printing. 


CI 


Space 1 additional line before 




printing. 


C2 


Space 2 additional lines before 




printing. 


C3 


Space 3 additional lines before 


• 


printing. 


CF 


Space 15 additional lines before 




printing. 


F0 


Skip to Channel (bottom of page) 




before printing. 


Fl 


Skip to Channel 1 (top of page) 




before printing. 


F2 


Skip to Channel 2 before printing. 


FF 


Skip to Channel 15 before 




printing. 



8 


9T 


9 


7T 


10 


CP (Low Cost) 


11 


LP (Low Cost) 


12 


DP 


13 


PL 


14 


DP 


15 


LP 


16 


9T 


18 


XX (special) 


19 


LD (logical device) 



If ASN has value 1, TYPE specifies the area that 
contains the disk file. If DAN is 0, TYPE must be 
set before opening. If DAN is 1, TYPE is set by 
the OPEN service. 



Value 


1 
2 
3 

4 
6 



Area 

SP 
FP 
BP 
BT 
XA 



user defined areas 



Word 1 



(Value 5 refers to area CK, which is reserved for 
system use. ) 

DEV/OPLB/RFILE contains one of three: 



NRT is the number of recovery tries to be allowed 

before outputting a device error message. 

DEVF is an indicator specifying whether the device 
assignment (when ASN has value 3) in force is 
directly to a physical device or indirectly through 
an operational label (1 means direct; means in- 
direct). See TYPE and DEV/OPLB RFILE discus- 
sion below. 

L is an indicator specifying whether the assigned 

device is a line printer or keyboard/printer. The 
indicator is set by the system at OPEN time. 

TYPE is a field indicating the type of device that 

is directly assigned if ASN has value 3 and DEVF 
has value 1. In this cose, TYPE is set when the 
DCB is opened, regardless of its prior content. 



Value 



Device 






NO (lOEX) 


1 


TYor LN 


4 


CR 


5 


CP 


6 


LP 


7 


DC 



The DCT index of the assigned device when the 
assignment is to a device (ASN equals 3 and DEVF 
equals 1). This must be set before opening if DON 
is 0. It is set by OPEN if DON is 1. 



The operational label table index of the assigned 
operational label when the assignment is to an op- 
erational label (ASN equals 3 and DEVF equals 0). 
This must be set before opening if DON is 0. It is 
set by OPEN if DON is 1. The index values for 
standard system operational labels ore 



Label 


Index Value 


C 


1 


OC 


2 


LO 


3 


LL 


4 


DO 


5 


CO 


6 


BO 


7 


CI 


8 


SI 


9 


BI 


10 


SO 


11 
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Optional operation labels may be provided by the 
user, or in connection with certain SYS GEN op- 
tions. Hie user is responsible for determining the 
Index values for his optional operational labels 
when specifying an operational label by index. 
These values are a Function of the order in which 
the optional operational labels ore specified at 
System Generation. 

The index value for the devices are also a function 
of the order in which the devices are specified at 
System Generation. 

3. When a DCB is assigned to a disk file (ASN 
equals 1), this field contains the index to the RFT 
(RAD File Table). This value is set when the DCB 
is opened. The RFT entry is created at OPEN if 
an entry does not already exist for the file. 

Word 2 

TYC is an indicator showing the type of completion 

for an I/O operation. TYC is set by the I/O sys- 
tem at the completion of each request that uses 
the DCB in a Type I mode (see discussion of Read 
and Write system calls below). The completion 
type codes ore listed in Appendix N. 

BUF is the address of the user buffer for requests 
whose FPTs do not include a buffer address. 

Word 3 

RSZ is the default record size in bytes (1 < RSZ 
532,767). Theparometer is used as the byte count 
for Read/Write requests that do not include a byte 
count. 

ERA is the address of the user's routine that handles 
errors associated with insufficient or conflicting 
information in the DCB or FPT. Zeros in this field 
are used to indicate that no user error routine ex- 
ists (see discussion of error and abnormal returns 
below). 



Word 4 

ARS is the actual record size in bytes. The param- 
eter is set by the I/O system when a request is 
completed. It is set in the DCB for Type I re- 
quests only. For ]/0 requests that will result in 
a data transfer of more than 32,767 bytes, a TYPE II 
request should be used since only 15 bits are avail- 
able for posting ARS in Type I requests. 

ABA is the address of the user's routine that handles 
abnormal conditions associated with insufficient or 
conflicting information in the DCB or FPT. Zeros 
are used to indicate that no user abnormal routine 
exists (see discussion of error and abnormal returns 
below). 



Information post word 4 is used only by the OPEN and ASSIGN 
CALs. While a DCB b open, all information of value to 
CP-R is in words 0-4. 



Words 5 and 6: 



If ASN = landTTL>7, words 5 ond 6 will be accessed 
by the OPENservice for an 8-byte Hie nameor numeric 
zero. Additionally, If TTL=6, four bytes of file name 
or zero will be obtained from word 5 only. 

If ASN = 3, DEVF = 0, and DON = 1, word 5 will be 
accessed by the OPEN service for an operational label 
in the second halfword. Word 6 need not be present. 

If ASN = 3, DEVF = I, and DON = 1, words 5 and 6 
will be accessed by the OPEN service for a device name 
in N0-N4, with blanks in N5-N7. 



Word 7: 

If word 7 is used, words 5 and 6 must be present even if 
they are not used. 

PI is a presence bit for the word containing AREA 
(PI = if not present; PI = 1 if present). 

P2 is a presence bit for the word containing A0-A3 
(P2 = if not present; P2 = 1 if present). 

P3 is a presence bit for the word containing A4-A7 
(P3 =0 if not present; P3 = I if present). However, 
if P2 is zero, A4-A7 will be ignored, regardless of 
the value of P3. 

Words selected by the presence bits must follow word 7 
in the indicated order. Words not selected must be 
omitted. 



variable-position optional words; 

AREA is a system or user disk area name. This pa- 
rameter is used only during the OPEN service, as 
described in the paragraph on the DAN field. If it 
Is omitted or zero when it is needed, OPEN pro- 
vides a default. 

-a* 

A0-A7 Is on account name , fi I led to eight characters 
with trailing blanks. The word containing A4-A7 
may be omitted if it is all blanks. This parameter 
is accessed only during the OPEN service when 
ASN=1 and the file name is not numeric zero. If 
ASN=1 and the file name is nonzero, but A0-A7 
are omitted, numeric zero, or all blanks, OPEN 
provides a default account name. 
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ERROR AND ABNORMAL CONDITIONS 



OPEN A FILE 



Certain error codes ore returned to the user's error or ab- 
normal return routines upon occurrence of various condi- 
tions. At entry to these routines, the error code is contained 
in byte of register 10, the DCB address is contained in 
the address field (low-order 17 bits) of register 10, and 
the address of the location following the CAL1 is contained 
in register 8. The previous contents of registers 8 ond 10 
are lost. 

Foreground users must provide error ond abnormal returns on 
all I/O requests with wait and on all CHECK requests. If 
background users omit the error and abnormal addresses, the 
system will take action as detailed below. The error codes 
are defined in Appendix N. 



I/O SYSTEM CALLS 

I/O system colls may be mode only when o user has been 
given control under the following circumstances: 

1. The background or foreground program loader has trans- 
ferred control to the starting address of the user's 
program. 

2. The user's centrally connected task has been given 
control upon the occurrence of its associated interrupt. 

Warning: Do not perform I/O system calls from o task 
connected to on interrupt of higher priority 
than the I/O interrupt. 



In all of the FPT formats which follow, an asterisk in 
bit indicates that indirect addressing is permitted. That 
is, if bit contains a 1, bits 15 through 31 contain the 
address of the parameter rather thon the parameter itself. 

Whenever a return is made to an abnormal or error address, 
the error or abnormal code will be in byte of register 10 
ond the address of the location following the call will be 
in register 8. 

Calls for which F3 (wait indicator) is not available are 
either immediate or synchronous. That is, control will 
never be returned to the caller until the service has been 
completed (see Appendix I for more detailed informa- 
tion). Primary task users should recognize that during 
any wait for completion of the service all lower priority 
tasks are blocked. 

If an error is detected in the col I and no error address is 
available, the situation will be handled similar to a trap 
and the user will be aborted unless he has eleeted to do 
his own trap handling. 



OPEN The OPEN system call opens the data file if it 

is not already open. If the addressed DCB is assigned to a 
device (directly or through an operational label), a count is 
kept of the number of open DCBs assigned to the device. 

If the DCB is assigned to o disk file, an entry is built In the 
RFT (RAD File Table) if one does not already exist and the 
index of the entry is placed in the DEV/OPLB/RFILE field of 
the DCB. A count of open DCBs assigned to the disk file is 
also maintained. The user may specify a buffer to be used 
in the File Directory search but this is not mandatory. The 
OPEN function will use available blocking buffers if such a 
buffer is not given. 

When a DCB assigned to a file is opened, the following de- 
faults for area and account names apply: 

1. If neither account name nor area name is specified, the 
calling task's account is used, and the area may be any 
public area. This provides the simplest specification, 
and the user need not be concerned with the possibility 
of name conflicts other than within his own account. 

2. If the account name is specified, but the area name is 
not, the file may be in any public area. This provides 
for area-independent Trie specification. 

3. If the area name is specified but the account name is 
not, the system account will be used. This case provides 
compatibility for code written before the addition of 
file account names. 

4. If the account name is all blanks, or numeric zero, it is 
treated as unspecified. 

5. If the disk area name is numeric zero, it is treated as 
unspecified. 



The error and abnormal addresses in the DCB may be set or 
changed at OPEN. The error and abnormal addresses will 
be copied from the FPT if present. The OPEN function causes 
the specified DCBs file-open indicator (OPEN)to be set to 1 . 

If the specified DCB is assigned to an operational label and 
the operational label, in turn, is assigned to a 7T device, 
PACK and BIN are set to 1. 

If a DCB is already open (OPEN = 1) for device-assigned 
DCBs when the OPEN function is called, an abnormal con- 
dition is signaled (see Appendix N). The device indicator 
(DEV/OPLB/RFILE) of the DCB is checked for validity. If 
it references a valid operational label or physical device, 
the DCB is marked open; if the device indicator is invalid, 
the DCB is not marked open and an abnormal condition is 
signaled (see below for the OPEN call format). 

For DCBs assigned (directly or through oplabels) to line 
printers or keyboard/printers, the L indicator in the DCB 
is set to 1 . 
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If a OED DPndd, R key-in it in affect, the file will not be 
opened. A DCB abnormal condition with code )C2F' exists. 

If the DC B is assigned to a device that has been declared 
to be nonsharable, the user will be given exclusive use of 
the device providing that it is currently available. If the 
device is alreody in use in another fob, the user's DCB will 
not be OPENed and on error condition will be returned. 



CLOSE A FILE 

CLOSE The CLOSE function closes a DCB by setting 

the DCB open indicator (OPEN) to 0, which may result in 
closing the assigned data file on a device or disk file. The 
CLOSE function decrements the "open DCB count" in the 
proper DCT or RFT entry and if the count becomes zero, 
the data file is closed. 

If the data file is to be closed and is a disk file opened for 
output, the directory entry for the disk file is updated with 
the information from the RFT entry and the entry is deleted 
from the RFT table. If the file is extensible, all extents 
past the one that contains the last record are deleted. 

If the data file is to be closed and is a disk file opened for 
Input only, the entry is deleted from the RFT table. 

If the file is on a 'non-system' disk pack, a DED DPndd, R 
key-in has been made, and th is is the last file to be closed, 
the system will output the message 

1 1 DPndd IDLE 



If the DCB is assigned to a device that has been declared to 
be nonsharable, the device will be marked as being avail- 
able to other jobs providing that no other DCBs are open to 
the device. 

Closing other types of data files requires no action. 



OPEN AND CLOSE SYSTEM CALL FORMAT 



optional (P1) r 



Error address 



S I 1 1 1 . i . Mt t 4 ■Hit il u ' A \ * n it H l H i. ii B l i. h i. K \ H H M i 
t 



optional (P2) r 



Abnormal address 



6 i i il« 5 4 Hi * mii!i3u « ul» v >• »!x> ji a jjlw is h zr\n 



optional (P11) f 



Blocking buffer address 



B 1 1 ! 5li ! i < !; » It Mil! IS u'lillt u II nix 31 »' hIjj 1! u i>'n h x ] 

where 

WordO 

Code is X'14' for OPEN, X'15' for CLOSE. 

DCB address is the address of the associated DCB. 

Word 1 

P. is the error address parameter presence indicator 

(0 means absent; I means present). 

P_ is the abnormal address parameter presence in- 
dicator (0 means absent; 1 means present). 

P. . is the blocking buffer address parameter pres- 
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ence indicator (0 means absent; 1 means present). 



Word Options 

Error address is the address of the entry to the user's 
routine that will handle error conditions. 

Abnormal address is the address of the entry to the 
user's routine that will handle abnormal conditions. 

Blocking buffer address is the address of a 257-word 
buffer to be used for file directory search if the 
DCB being closed is assigned to a disk file. 



OPEN and CLOSE system calls have the format 

CAL1,1 address 
where address points to word of the FPT shown below, 
word 



* 


Code 


r\ n 


DCB address 


u ■— 


« 


i j 1 1 1 i « * 


• * 10 III IJ u n 


istk 17 u nix Ji U bli. h i» trtlTWTPii 



READ A DATA RECORD 

READ The READ function causes the I/O system to read 

a data record into a user buffer from the device or file spe- 
cified by the DCB. 

An implicit OPEN will be performed oVthe DCB if the ad- 
dressed DCB is closed when the READ request is mode. 



word 1 








1 


r 

2 


ft 


n 


II 


n « 




U U 





i 


i i\t 


strut 


10 





In all FPTs for I/O functions where an optional parameter 
is not used, the parameter word must be omitted from the FPT 
and the corresponding presence indicator (P n ) set to 0. 
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READ requests may specif/ either a "wait for completion" 
or an "immediate return" condition. Foreground requests 
with wait must include error and abnormal returns in the 
FPT. Background requests can omit these addresses and 
have the system handle error and abnormal conditions. 

Should the input record be physically longer than the speci- 
fied buffer length, data is lost and the user is notified 
through an abnormal return with code 07. 

Should the input record be physically shorter than the speci- 
fied buffer length, the buffer is not filled and the actual 
record length is posted in the FPT or DCB. 

Input from the card reader is performed either in automatic 
or binary mode. If the cord reader is not the C device, the 
input mode is determined by the BIN flag in the DCB. The 
C device is always read in automatic mode. Foreground 
programs may not read the C device as this would disrupt 
the background job stream. 

Input from the C device results in all control commands ( ! 
5n column 1) being intercepted by the I/O system. Any con- 
trol command other than !EOD causes an abnormal return 
with a code of 06 in register 10. The input record is kept 
in the CP-R control commond buffer. If an attempt is made 
to read this some device again, an error return with code 54 
is given (see Appendix N). 

An SEOD record encountered from a card reader on a READ 
request results in an abnormal return with code 05. 

For direct access input from disk files, the user includes a 
key in the FPT. All READ requests without a key parameter 
are assumed to be sequential access requests and result in 
the next record in order being input into the user buffer. 
For sequential input from blocked files, the request may not 
result in an actual disk access. 

For sequential access input from compressed files, the I/O 
system decompresses the record in transmitting it to the user 
buffer. 

Type II READ requests must include in their FPTs a completion 
status parameter in which the type of completion code and 
the actual byte count are posted. 

A Type I READ request that finds the DCB busy with o pre- 
vious Type I request results in an error condition (error 
code 48). 



WRITE A DATA RECORD 

■RITE The WRITE function causes the I/O system to 

write a data record from a user buffer to the device or disk 
file specified by the DCB. 

WRITE requests may specify "wait" or "no-wait". As with 
READ requests, foreground WRITE requests specifying wait 
must include error and abnormal return addresses in the FPT. 



For direct access output to disk files, the key address param- 
eter Is included in the FPT. All WRITE requests without a 
key address parameter present are assumed to be sequential 
access requests. 

For output to compressed files, the I/O system compresses 
the record in transmitting it to the system blocking buffer. 

Type II Write requests must include a completion status pa- 
rameter word in their FPTs in which the I/O system will post 
the type of completion code and the actual byte count. 

A Type I request that finds the DCB busy with o previous 
Type I request results in an error condition (error code 48). 



READ AND WRITE FUNCTION CALL FORMAT 
Calls for these functions are of the form 

CAL1,I address 
where address points to word of the FPT shown below, 
word 



* 



Code 

12 3 14 I. 








DCB address 



word I 



',,0- 



f lll l} ' II u l. l i , l 1 I t 'i i y, jl B ' } i' ?. ' l V» 1 n ' n ' » ' s 



optionol (PI) 



7 i 3 ) 1 « > « If - ii nli} li 



Error oddress 



i» .'/ ii }; j-.IJ. , » ;>'}* 5* it 3 



optional (P2) 



Abnormal address 



1 i j jit i t Ml * it nli} i] M 'ul it l> li itUi 2> tililk 2s It 1+lH 4* » : 

optional (P3) 



Buffer address 



T*~t mI« } t 7I1 t 10 nli; 1;, i/islit 17 11 i«)x j> 72 231m 25 h 27l» 74 io 3 

optionol (P4) 



Byte count 



1 3 3 I 4 . • 7 I I ' 15 III :3 13 14 111 to 17 It Itlx 21 22 Jjll. 2S » Jjljl T> 30 J' 



optional (P6) 



*0 



" 01 



2 3 1 4 S • 7 i I 9 io III 12 13 14 Ijl ie IT It 1*1 70 21 22 73! 24 25 2* 77 1 21 74 30 3 

optional (P7) 



* PC 



I 2 J I4 S 4 7 li » it III 12 13 14 III Uk 17 li |4|}6 J; 72 Jjflt }j 24 J}It» H H ! 

optional (P8) 



Key 



1 2 j1* S 4 7 l» ? 10 111 12 13 I* lit 10 i> IS iflxi 2i i2 W 2* 25 26 27i2l 2* 30 3 



opt 


ional (P9) 








I 




End-action address/no. 




i 


2 3 >4 j • 


Jit 4 10 III! 


2 13 14 


bill 17 16 I)':. 21 22 ii'n 2: It 2?l» 2» X j 
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optional (P10) 








Completion y _ 
code ? ° 

\ ,1,1.1 .T t't H nl 




U 11 M 


Actual byte count 

'uU ■> w M» i, h ait. t» k mm. a », 



optional (PIT) 



Blocking buffer oddress 



i » il l i « ? l i i w li 1 13 1 3 n ' u l u i> ii mmm H l mrat i>\r * » t 



optional (P13) 



Time 



l 1 1 J I 4 5 » ? I t 4 It 111 12 13 I* 15 1 16 IT II l» tlC 21 22 2jl?4 25 2* J?l» 2. X 3 



where 



F. = 1 specifies that I/O is to be allowed only if 
the device has been deactivated (i.e., marked 
"down"); this bit is for diognostic-rprogram usage. 

= specifies that I/O is to be allowed only if 
the device has not been deactivated; normol pro- 
gram usage. 



is the direction indicator for READ (0 means for- 
ward; 1 means reverse). This indicator has effect 
on magnetic tape Read/Write operations only. 



"- is the wait indicator (0 means no-wait; 1 means 

wait for I/O completion). 



WordO 

Code is X'10' for READ ond X' IT for WRITE. 

DCB oddress is the address of the associated DCB. 

Word 1 



P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

P. is the abnormal address parameter presence indi- 
cator (0 means absent; 1 means present). 



F . is the RAD Check-Write indicator (1 means a 

read or write on a RAD or disk pack will be fol- 
lowed by a Check-Write operation; means a nor- 
mal read or write will be performed). 



F_ = I is the abort override indicator. If set, con- 

trol will be returned to calling instruction + 1 
if errors are detected and no error address param- 
eter has been provided. 

F_ is a delete on post indicator (1 means delete the 

event when it is posted — no CHECK will be per- 
formed and the user's FPT/DCB will not be posted; 



means a CHECK will be performed) 
meaning only when Fg = 0. 



Fa has 



P. is the buffer oddress parameter presence indi- 

cator (0 means absent; 1 means present). 



Word Options 



P . is the byte count parameter presence indicator 

(0 means absent; 1 means present). 



Error address is the address of the entry to the user 

routine that will handle error conditions for re- 
quests specifying wait. 



P. is the byte displacement parameter presence 

indicator (0 means absent; 1 means present). 



P_ is the prompt character presence indicator 



(0 means absent; 1 means present) 



P is the key parameter presence indicator (0 means 

absent; I means present). 

P. is the end-action parameter presence indicator 

(0 means absent; 1 means present). 



P.. is the completion code parameter presence indi 

eator (0 means absent; 1 means present). 



P.. is the blocking buffer address parameter pres- 

ence indicator (0 means absent; I means present). 

P.- is the time interval parameter presence mdi- 
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cator (0 means absent; 1 means present). 



Abnormal oddress is the address of the entry to the 

user routine that will handle abnormal conditions 
for requests specifying wait. 

Buffer address h the word address of the user buffer 
to be used in the I/O operation. Data is written 
from or read into this buffer. If this parameter is 
omitted, the buffer address is taken from the DCB 
(BUF). The buffer address may not be a register. 

Byte count is the size in bytes of the data record. 
If this parameter is omitted, the record size is 
token from the DCB (RSZ parameter). 

BTD is the byte displacement (0-3) from the word 
boundary of the beginning of thedata record. If 
this parameter is omitted and the Buffer address pa- 
rameter is included in the FPT, value is assumed 
for BTD. If both parameters are omitted from the 
FPT, the values of the DCBare used for both. 

PC is a prompt character to precede a keyboard- 
printer read with editing. If not specified, the 
prompt character associated with the job is used. 
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Key is the number of the granule within a disk file 
or area to be accessed with the direct-access 
method- For the device-occe» method. Ice/ it the 
number of the sector to be accessed, relative to 
the beginning of a disk. 

l,End- action address/no. I indicates the contents 

of the End-action address/number field. End- 
action is allowed only for foreground. 



Value 
Value 1 

Value 2 

label. 



indicates an end-action address. 
indicates an interrupt number, 
indicates an interrupt operational 



Value 3 indicates a completion signal address. 

End-action is taken only in the case of an actual 
I/Ooperation involving a peripheral device (i.e., 
end-action will not occur for blocked disk file I/O). 

Completion status is the word wherein the I, O system 
posts the completion parameters for the request. Pre- 
sence of this word indicates that the I/O request 
should be of Type II (see Pio>- The I/O system ini- 
tializes the completion code and actual byte count 
to zero before starting the operation. At comple- 
tion of the request the actual byte count and the 
completion code are posted if the wait indicator 
was set. Otherwise, these parameters are posted 
when the service is CHECKed. 

BUSY is the FPT busy indication that is set and 
maintained by the I/O system to indicate that a 
.Type II request using the FPT is in progress. 

Blocking buffer address is the address of a 257-word 

buffer to be used for file directory search if the 
DCB is being opened to a disk file. 

Time interval is the maximum number of seconds that 

the caller will wait for the CALL to complete. If 
notspecified theCALLwill not be timed-out. Note 
that the I/O system may time out a device but this 
is independent from the use of the "Time Interval" 
parameter. 



REWIND. UNLOAD. AND WRITE EOF FUNCTIONS 

REW The Rewind function causes a data file to be posi- 

tioned at its beginning if the file is on magnetic tope or 
disk. Rewind of a file on magnetic tape is accomplished by 
causing the tape drive to rewind to beginning of tape. Re- 
wind of a disk file is accomplished by setting the file posi- 
tion parameter in the RAD File Table (RFT) so that the next 
sequential access request on the file results in the first rec- 
ord being accessed. A Rewind request for an extensible disk 
file results in the file being positioned at the first record of 
the first extent. A Rewind request for a data file on any 
other device results in no action being taken. 

UNLOAD TheUnload request results in the sameoction 

as Rewind except that magnetic tapes are rewound "off- 
line". When the rewind is concluded, operator action is 
required before the device can be used again. 



■EOF Write End-of-File causes an EOF to be written 

if the addressed DCB is assigned to a magnetic tape unit. If 
the DCB is assigned to a card punch, and IEOD. record is 
output. If the DCB is assigned to a disk file, an implicit 
EOF is written. If the disk file is extensible, all extents 
past the current one will be deleted. If the DCB is assigned 
to any other type of device, no action is token. 

Rewind (REW), Unlood (UNLOAD) and Write End-of-File 
(WE OF) colls are of the form 

CALIJ address 

where oddress points to word of the FPT below. 



word 












* 


Code 

| 2 3 1 « i o * 


P 


f 








•-' -r - it ■ 


DCB address 



word 1 (optional) 



o 



T i i i ' 4 > » - 1 1 



» '.o 00 u 



o — 



optional (PI) 








Error address 


U 


u 



optional (P2) 



ll 



Abnormal oddress 



op 


Fional (P9) 






1 




1 - ■. li ; . - U : 





End-action address no. 

'..■-; ■>'•.■ • -' .;':■ . . 1. ).■■■■ . ' 



optional (P10) 






Completion 
code 


■ 



s 

e 


n n 


U (J 

1 . ■: ■■' . . ' - - i ■': : :. .'-'.. \ -- - ■- ' 



optional (PI3) 



Time Interval 



i i i 3 • « ; » * '• r 



where 



WordO 

Code is X'01' for REWIND, X'02' for WEOF, and 
X'03' for UNLOAD. 



P =0 



meons word 1 of the FPT is absent; 

= I means word 1 of the FPT is present. 

If 0, REW and UNLOAD ore done without wait and 
WEOF is done with wait. Otherwise, the action 
taken depends on word 1 . 

DCB address is the oddress of the associated DCB. 



Word 1 (optional ) 



is the error address parameter presence indicator 



(0 means absent; I means present). 
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h the abnormal address parameter pretence 
Indicator (0 means absent; I means present). 

b the end-action pqiom e to r presence indicator 
(0 means absent; 1 means present). 

is the completion code parameter presence 
indicator (0 means absent; 1 means present). 

is the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 



f- = 1 specifies long wait. 

F. = 1 specifies that I/O is to be allowed only if 
the device has been deactivated (i.e., marked 
"down"); this bit is for diagnostic-program usage. 

= specifies that I/O is to be allowed only if 
the device has not been deactivated; normal pro- 
gram usage. 

F„ is the wait indicator (0 means no-wait; 1 means 
wait for I/O completion). 



Word Options 

Error address is the address of the entry to the user 
routine that will handle error conditions for re- 
quests specifying wait. 

Abnormal address is the address of the entry to the 
user routine that will handle abnormal conditions 
for requests specifying wait. 

I, End-action address/no. I indicates the contents 
of the End-action address/number field. End- 
action is allowed only for foreground. 

Value indicates an end-action address. 

Value 1 indicates an interrupt number. 

Value 2 indicates an interrupt operational 
label. 

Value 3 indicates a completion signal address. 

End-action is token only in the case of an actual 
I/O operation involving a peripheral device. 

Completion status is the word wherein the I/O 
system posts the completion parameters for the re- 
quest. Presenceof this word indicates that the I/O 
request should be of Type II (see Pjq). The I/O 
system initializes the completion code to zero before 
starting the operation. At completion of the re- 
quest the completion code is posted if the wait 
indicator was set. Otherwise, these parameters 
are posted when the service is CHECKed. 

BUSY fa the FPT busy indication that is set and 
maintained by the I/O system to indicate that a 
Type II request using the FPT is in progress. 



Time interval is the maximum number of seconds that 
the caller will wait for the CALL to complete. If 
not specified the CALL will not be timed-out. Note 
that the I/O system may time Out a device but this 
is independent from the use of the "Time interval " 
parameter. 



FILE AMD RECORD POSITIONING FUNCTIONS 

These functions are used to alter position within a data file 
on magnetic tape or disk. 



PFIL.PREC A Position File (PFIL) call causes a mag- 

netic tape to be positioned at the beginning or end of the 
current file if a backward or forward direction respectively 
is specified and no skip is requested. If skip is requested, 
the tape is positioned as above except that the file mark is 
skipped over in the specified direction. Position File for- 
ward without skip positions the tape at the end of the 
current file (before the EOF). With skip, Position File 
forward positions the tape at the beginning of the next file. 

Position File causes a "rewind" of disk files when "backward" 
is specified, and positioning after the last record in a disk 
file when "forward" is specified. The file will be positioned 
after the last record in the last extent if the file is extensible. 

Position Record (PREC)causes a tape or disk file to be moved 
n records in the specified direction. For extensible disk 
files, this may require crossing extents. 

Position File and Position Record are ignored when the 
data files are on devices other than magnetic tape or disk 
file. 

File and Record positioning calls are of the form 

CAL1,1 address 
where address points to word of the FPT shown below. 



word 
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opt 


ionol (P9) 
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End-action oddress/no. 

ilU 1? U dim II 8 HlW » 14 fllS » ■ II 
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optional (P10) 



Completion 
code 



Actual record count 



t I } )U i i >l l t It n i l! H u ' lsU i > H W l K ?i il il l i. H 'l Tg l H X * i 



optional (PI 3) 



Time Interval 



o i a l l « 1 t >U ♦ it n l u 13 u ula ij » ir l ao ii b Bit. li fc glH Hit 1' 

where 

WordO 

Code is X*1C for Position File (PFIL) and X'lD' 
for Position Record (PREC). 

P- = 1 indicates the explicit use of the P , P]Q, 
Fj, and WAIT parameters. 

= Po, P-|Q, F|, and WAIT are ignored and the 
CAL is processed as Type I with wait and no end- 
action. 

DCB address is the address of the associated DCB. 

Word 1 

P. is the record count (n/address parameter pres- 

ence indicator (0 means absent; 1 means present). 
P] is ignored for Position File. If P] is absent, 
n assumes a value of 1. 

P_ is the error address parameter presence indicator 
(0 means absent; 1 means present). 

P_ is the end-action parameter presence indicator 
(0 means absent; 1 means present). 
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is the completion code parameter presence 
indicator (0 means absent; 1 means present). 



P.- is the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 

F. = 1 specifies that I/O is to be allowed only if 
the device has been deactivated (i.e., marked 
"down"); this bit is for diagnostic-program usage. 

= specifies that I/O is to be allowed only if 
the device has not been deactivated; normal pro- 
gram usage. 

SKIP indicates whether the EOF is to be skipped 
over in positioning magnetic tape. This parameter 
has significance only for Position File and on mag- 
netic tape (0 means no skip; 1 means skip). 



DIR Is the direction indicator (0 means forward 
positioning; 1 means backward positioning). 

WAIT is the wait indicator (0 means no-wait; I 
means wait for I/O completion). 



Word Options 

n is the number of records to position. 

Error address is the address of the entry to the user's 

routine that will handle error and abnormal condi- 
tions (EOT, BOT, etc.), for this I/O operation. 
EOF is considered an abnormal condition for PREC. 

I, End-action address/no. I indicates the contents 

of the End-action address/number field. End- 
action is allowed only for foreground with the ex- 
ception that no end-action will take place for 
blocked disk file I/O. 

Value indicates an end-action address. 

Value 1 indicates an interrupt number. 

Value 2 indicates an interrupt operational 
label. 

Value 3 indicates a completion signal address. 

Completion status is the word wherein the I/O 

system posts the completion parameters for the re- 
quest (presence of this parameter indicates that 
the request is of Type II). The I/O system initial- 
izes the completion code and actual record count 
before starting the operation. At completion of 
the request the actual record count and the com- 
pletion code are posted in the word if the wait 
indicator is set. Otherwise, these parameters are 
posted when the service is CHECKed. BUSY is 
the FPT busy indicator that is set and maintained 
by the I/O system to indicate that a Type II I/O 
request using the FPT is in progress. 

Time interval is the maximum number of seconds that 
the caller will wait for the CALL to complete. If 
not specified the CALL will not be timed-out. Note 
that the I/O system may time out a device but this 
is independent from the use of the "Time interval" 
parameter. 



ALLOT, DELETE, AMD TRUNCATE FUNCTIONS 

ALLOT The ALLOT function h used to define a new 

file in a permanent disk area. This is accomplished by add- 
ing a new entry to the file directory in the specified area. 
The defined file will receive the specified size and format. 



i 
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This coll has the form 
CAL1,7 address 
where oddress points to word of the FPT shown below 



wordO 








X'5A' 
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word 1 
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optionol (PD , 



Error oddress 



I 1 3 I 4 5 4 7 It » K> lllu 13 14 isl It 17 II ttlx 21 22 23I24 23 » 27l» ?> 30 3 

optionol (P2) , , , 



1 2 3 I 4 5 1 7 I I « 10 III 12 13 14 15 ' It 17 II 1*1 20 21 22 ulu li 24 B\U H JO 1 

required (P3) 



1 
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optionol (P4) 



c 7 



c 8 



I I 3 I 4 3 t 7I1 » 10 111 12 13 14 ul It 17 I* t*!iS 21 li 23134 li 31 PlH H it i 

optionol (P5) i 



FSZ 



1 J 3 I 4 3 4 7 I I » 10 111 12 13 14 ul It 17 II l»l» 21 22 JjUt 24 24 pi 21 It JO 3 

optional (P6) | | 



RSZ 



c 'i 1 iU ; t 7 1 1 ; m u l m 13 u ulit n n w i n ;i a H l ai b M g l a w * a t 



optional (P7) 



ESZ 



4 i 1 1 1 4 s t Mi 4 w nhj 13 u ulit 17 11 »l» Ji K jjim is 24 UlH 1* U ii 
optional (P8) 



GSZ 



D * I 3 3 It i 4 7 It > It 11 1 lili 14 H i lt 17 It H l K il Bb i UUk g l W lUii 

optional (10) 



Completion 



6 I 2 3 I 4 S 4 > II ^ 10 llll! 13 14 Ijl It 17 li l»l»0 21 22 2jlj4 23 » pl» 2« X 31 

optionol (P14) 



account name address 



4 * 1 1 4 1 4 t * Mi ♦ it u l ii ii » is l it i7 li i4 l t! ii H H l 2t H tt ft l H B » i 
where 

WordO 



X'5A' specifies the code for the ALLOT call. 

Area is the name of the permanent area in which 
the file is being defined. If the disk area name 
value is zero, the disk area is unspecified. 



Word 1 

P. isthe error address parameter presence indicator 
(0 means absent; 1 means present). 

P 2 It the file organization parameter presence in- 
dicator (0 means absent; 1 means present). 

?. is the file name second word parameter presence 
indicator (0 means absent; 1 means present). 

P, is the file sire parameter presence indicator 
(0 means absent; 1 means present). 

P. is the record size parameter presence indicator 
(0 means absent; 1 means present). 

P_ is the extent size parameter presence indicator 
(0 means absent; 1 means present). 

P. is the granule size parameter presence indicator 
(0 means absent; 1 means present), 

P.- is the type-of-completion parameter presence 
indicator (0 means do not post; 1 means post type 
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of completion) 

is the account name address parameter presence 
indicator (0 means absent; 1 means present). 



F- is the resident foreground load module indicator 
and is applicable only if the area is FP. A zero 
means the file is not to contain a resident foreground 
load module. 

F, is meaningful only if ESZ option is present and is 
used to determine whether or not the file should be 
combined with its extents if the area is squeezed 
(1 means do not combine extents; means combine 
extents ). 

F- = 1 is the abort override indicator. If set, con- 
trol will be returned to calling instruction -I- 1 if 
errors are detected and no error address parameter 
has been provided. 



Word Options 

Error address is the return address for all errors. 
The error code will be in byte of register 10 
and the address of the location following the call 
will be in register 8. 

C. ore the EBCDIC characters naming the disk file 
being defined. If Cy-Cgare bfcnks, the word con- 
taining them may be omitted. 

ORG is the file organization type: 

00 for unblocked 

01 for blocked 
10 for compressed 

The default is unblocked. 
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FSZ is Hi* file size in logical record*. Tho default 
it 1000 records. 

RSZ Is the number of words per record. The logical 
size is used in sequential!/ accessing a file. For a 
compressed file, record site is omitted and the 
monitor blocks compressed files into 256-word rec- 
ords. Blocked files hove a default value equal to 
128 words per record. If the record size is greater 
than 128 words, unblocked organization will be 
given. Unblocked files have a default record size 
equal to the granule size. The maximum record 
size is 16,383 words. 

ESZ is the size of file extents, in logical records, 
to be allocated and attoched to the file anytime 
the file is out of space. A value of zero means 
that file extentswill be the samesizeastheoriginal 
file (FSZ). The default is no automatic file 
extension. 

GSZ is the granule size in words and is used far 
direct access only. The default size will be equal 
to the disk sector size. The maximum granule size 
is 16,383 words. 

Type completion is the byte in which a type-of- 
completion code will be posted by the service 
function. 

account name address fa the address of a two-word 

data block that contains the account name in 
EBCDIC, Tilled to eight characters with trailing 
blanks. If the account name fa all blanks or numeric 
zero, it fa assumed to be unspecified. 

Software write protection fa provided which allows fore- 
ground load modules to ALLOT files in any data area. 
Background load modules may only ALLOT files in back- 
ground data areas. Software write protection may be over- 
ridden with an SY key-in. 

The following defaults for area and account names apply; 

1. If neither account name nor area name is specified, the 
calling task's account is used, and the area may be any 
public area. This provides the simplest specification, 
ond the user need not be concerned with the possibility 
of name conflicts other than within his own account. 

2. If the account name is specified, but the area name is 
not, the file may be in any public area. This provides 
the area-independent file specification. 

3. If the area name is specified but the account name is 
not, the system account will be vied. This case provides 
compatibility for code written before the addition of 
file account names. 



OEIETEJRUNCATE The DELETE system call is used to 

delete a disk file in a permanent area by removing the entry 
from the directory in the specified area. The space that was 



formerly used is available for a new file. If the file is 
extensible, all extents in the file are deleted. TheTRUNCATE 
system call is used to truncate empty space from the end of 
the specified file in a permanent area. The allocated space 
will be set equal to the actual length of the file. If the file 
is extensible, the last extent will be truncated to the last 
record in that extent. Prior extents are unaffected. Note 
that if the file size fa zero, the file will not be truncated. 

Calls for these functions are of the form 

CAL1,7 address 

where address points to word of the FPT shown below, 
word 



Code 



1 0- 



Areo 



1 I 3 I* 5 4 7 It • 10 lllli 13 14 I5I14 1? II I* 1 20 21 2! hI»4 2i fe iftn 

word I 
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optional (PI) 



Error address 
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required (P3) 
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optional (P4) 



c 7 
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optional (P10) 



Completion 



*-T- 



tl J i » 



I I H l l l l} I » U l illi IT It Wig H B BtH B % Pl il E ]C 3 



optional (PM) 
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WordO 

Code X'SV specifies the DELETE call. X'5C spe- 
cifies the TRUNCATE call. 

Area is the name of the permanent area that con- 
tains the specified file. If the disk area name 
value is zero, the disk area is unspecified. 

Word 1 

P. is the error address parameter presence indica- 



tor (0 means absent; 1 means present). 



P . is the file name second word parameter presence 
indicator (0 means absent; I means present). 

P.- is the type-of-complerion parameter presence 
indicator (0 means do not post; 1 means post type 
of completion. 

P. . is the account name address parameter presence 
indicator (0 means absent; 1 means present). 
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F 7 hai abort override indicator (0 means abort if 
errors ore defected and no error address is provided; 
1 means do not abort if errors are detected but no 
error address is provided). 



Word Options 

Error address is the return address for all errors. The 
error code will be in byte of register 10 and the 
address of the location following the call will be 
in register 8. 

C. are the EBCDIC characters defining the disk file 
1 to be deleted or truncated. If C5-Cgareall blanks 
they may be omitted. 

Type completion is the byte in which a type-of- 
completion code will be posted by the service 
function. 

account name address is the address of a two- word 
data block that contains the account name in 
EBCDIC, filled to eight characters with trailing 
blanks. If the account name is all blanks or numeric 
zero, it is assumed to be unspecified. 

Software write protection is provided that allows foreground 
load modules to DELETEARUNCATE files in any data area. 
Background load modules may only DELETEARUNCATE files 
in background data areas. Software write protection may 
be overridden with an SY key-in. 

The following defaults for area and account names apply: 

1. If neither account name nor area name is specified, the 
calling task's account is used, and the area may be any 
public area. This provides the simplest specification, 
and the user need not be concerned with the possibility 
of name conflicts other than within his own account. 

2. If the account name is specified, but the area name is 
not, the file may be in any public area. This provides 
for area- independent file specification. 

3. If the area name is specified but the account name is 
not, the system account will be used. This case provides 
compatibility for code written before the addition of 
file account names. 



ALLOT OR DELETE SYMBIONT FILE 

JOB The JOB call is used to maintain symbiont files by 

performing the following functions. 

e Allocate a job file in the input symbiont area, 
e Check status of a previously allocated job file, 
e Delete a job waiting in the symbiont area. 



The JOB call has the following format: 

CAL1,7 address 

where address points to word of the FPT below. 
WordO 
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optional (PI) 



Error Address 



I } 3 1 4 5 4 7 It 4 10 III 12 13 14 lil 14 17 H If! 20 21 2! 23! 24 25 2s 2? 1 26 « X 3 

optional (P4) 



Batch file name address 



1 3 J I 4 5 4 7 1 1 » K III 13 1J H lill* 17 it 1H2O }l h 23 1 34 }5 24 27 I}| 7? X 

optional (P5) , 



Job number 



1 2 3 I 4 3 4 7 1 1 « 10 111 12 13 14 I5l U 17 II l?lx 2) 22 23I24 35 it 37 1 2E 7S X 

t 

optional (P6) 



SUTUS 



11 m inimi n i u u u u l u \i 11 w i m i g am s a g i ary it j 
optional (P7) 



Jobs Waiting 
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optional (PIP) 



TYC 
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account name address 
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where 

WordO 

X'67' specifies the code for the JOB coll. 

Word 1 

P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

4."* 

f. is the batch file name address parameter presence 
indicator (0 means absent; 1 means present). 

P 5 is the job number parameter presence indicator 
(0 means absent; 1 means present). 

P. is the job status parameter presence indicator 
(0 means absent; 1 means present). 
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10 



14 



b the jobs waiting parameter pretence indicator 
(0 means absent; 1 means present). 

is the type completion parameter presence 
indicator (0 meons absent; 1 means present). 

is the account name address parameter presence 
indicator (0 means absent; 1 means present). 

I means to delete all symbiont Hies associated 
with the specified job number. meons no files 
ore to be deleted. Note that when F2 = 1, the job 
number parameter (P5) must be present. 

is the abort override indicator (0 means abort if 
errors are detected and no error address is present; 
1 means do not abort if errors are detected and no 
error address is present). 



Word Options 

Error address is the address of the entry to the user's 

routine that will handle error conditions. 



account name address is the address of a two word 
data block that contains the account name in 
EBCDIC, extended to eight characters with trailing 
blanks. If the account name is ollblanksor numeric 
zero, it is assumed to be unspecified. 

The following defaults for area and account names apply: 

1 . If neither account name nor area name is specified, the 
calling task's account is used, and the area may be any 
public area. This provides the simplest specification, 
and the user need not be concerned with the possibility 
of name conflicts other than within his own account. 

2. If the account name is specified, but the area name is 
not, the file may be in any public area. This provides 
for area- independent file specification. 

3. If the area name is specified but the account name is 
not, the system occount will be used. This case provides 
compatibility for code written before the addition of 
file account names. 



Batch file name address is the oddress of a three- 

word data block that contains on areo name in the 
first word in bits 16—3 1 in EBCDIC and a file name, 
in EBCDIC, left-justified with training blanks in 
the second and third words. Presence of this 
parameter indicates that an input symbiont file is 
being defined and the symbiont file will redirect 
symbiont accesses to the program deck in the spe- 
cified disk file. 

Job number is the word wherein the system will post 
the assigned job number when an input symbiont 
file is defined. 

When the status option is specified, job number iden- 
tifies the job for which status is being requested. 

Job status is the word wherein the system will post the 
status of the file whose identification is specified in 
the "job number" parameter. Job status may also be 
requested when defining an input symbiont file. Job 
status may be one of the following: 

= completed 

1 = running 

2 ~ waiting for execution 

3 - does not exist 

Jobs Waiting is the wordwherein the system will 

post the number of jobs ahead of the specified job 
number. The jobs waiting parameter may be re- 
quested on a status request or when an input sym- 
biont file is being defined. 

TYC indicates the type of completion of the re- 
quested service. 



PRINT AMD TYPE FUNCTIONS 

PRINTJYPE The PRINT function couses the system to 

list the user's message on the listing log device (operational 
label LL). The TYPE function causes the system to list the 
user's message on the operator console device (operational 
label OC). These functions ore reentrant and available to 
foreground programs- Error and abnormal conditions result- 
ing from these functions are ignored. 

Print and Type may be performed without a wait for com- 
pletion, but the user is warned that changing the output 
buffer after return from such o request may result in the 
output message being modified. 

Calls for these functions are of the form 

CAM, 2 oddress 

where address points to word of the FPT shown below. 



word 
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o i ' j y\* 



18 ''Ix 2i 21 2jU* 7 16 77l» KX ] 



word 1 














p 
i 








1] 







• 


F 
} 





T 


1 2 i ^4 S ft 


k . ,. 


n 


U >4 ■*! 16 1 


- It 1*1 » 21 22 2>!» 25 M 


27 


» » X ]< 



word 2 (PI) 
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optional (P13) 



Time Interval 



t i i iU i » > l . * tt u l H ij u .i l u » tf limn H H l i. Hit gl UM It i 
where 

WordO 

Code is X'OT for Print and X'02' for Type. 

Word 1 

P. rs the message address parameter presence indi- 

cator (Pj = 1). 

P.« is the time interval parameter presence indi- 

cator (0 means absent; 1 means present). 

F« is the wait indieotor (0 means no-wait; 1 means 

wait for I/O completion). 

Word 2 

Message address is the address of the first word of 

the message. Note that the first byte of the first 
word of the message must specify the number of 
characters to be listed, up to a maximum of 1 32 char- 
acters for a line printer and 85 characters for a 
typewriter. The odd r ess may be indirect and/or in 
a register. If the message is in registers, the wait 
bit must be set. 

Time interval is the maximum number of seconds 

that the caller will wait for the CALL to complete. 
If not specified the CALL will not be timed-out. 
Note that the I/O system may time out a device 
but this is independent from the use of the "Time 
Interval" parameter. 



DEVICE 

The DEVICE/file Mode function is used to set the following 
parameters: 

Modes (MOD, ASC, D/P) in the addressed DCB. 

Record Size (RSZ) in the addressed DCB and in the 
RFT entry if the DCB is assigned to an output file. 

File Organization in the assigned file's RFT entry if 
the DCB is assigned to an output file. 

-Granule Size in the assigned file's RFT entry if the 
DCB is assigned to an output file. 

The parameters set in the RFT entries for permanent files will 
be written into the file directory entry for the file when the 
file is closed. Thus, this function defines the parameters 
for permanent disk files. 



This function is of the form 

CAL1, 1 address 
where address points to word of the FPT below. 
word 



Code 



DCB address 
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1 2 114 S * 7 It * w 111 12 13 14 1*1 16 17 It 1*120 21 22 2l\u 2i 26 2712S If ]G ) 

optional (P3) 



GSZ 



• 1 2 J 1 4 i t 7 It ' » 111 12 13 U ljll» 17 It wljo II 22 2ll24 2) M I7l2l r> X . 



optional (P4) 



NRT 



1 2 1 1 4 i 6 7 I P • 10 111 12 13 14 I5I16 17 It »l]0 21 22 ulj4 is it bltt h 30 3 

where 

WordO 



Code is X'22* for Device/File Mode. 

DCB address is the address of the associated DCB. 

Word 1 



P] is the record size parameter presence indicator 

(0 means absent; 1 means present). 

P2 is the file organization parameter presence in- 

dicator (0 means absent; 1 means present). 

Po is the granule size parameter presence indicator 

(0 means absent; 1 means present). 

P4 is the number of retries parameter presence 
indicator (0 means absent; 1 means present). 

Fq 1 means ASCII translation, means EBCDIC. 

F. 1 means unpacked format (7T) or 800 bpi (9T se- 
lectable density); means packed format or 
1600 bpi. « 

F_ I means BIN; means BCD. 

Word Options 

RSZ is the maximum record size specification, in 
bytes. 
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Word Options (cont. ) 

ORG is the file organization type: 

00 for unblocked 

01 for blocked 
10 for compressed 

GSZ is the granule size in bytes. 

NRT is the number of error recovery tries. 



DEVICE CONTROL FUNCTIONS 

The DEVICE Control functions cause the system to set the 
vertical-format-control or direct record control indicator 
of the specified DCB to 1 or to 0. 

This call has the form 

CAL1,1 address 

where address points to word of the FPT below, 
word 



word 1 



Code 



DCB address 



6 I J 3 I 4 S i Ml » 10 III 12 13 14 isl Is 17 II I»lj0 21 22 23 1 » 25 It 2?!n !» X 31 



word 1 










/ 


« n 


f 
3 





U <J 


o i 2 m 


5 * ! 


II 9 10 111 12 13 1 


4 15116 17 II 1*120 21 22 23124 25 26 


2: 


M 3» 30 31 



where 



WordO 

Code is X'05' for DEVICE/Format Control. 

X'OB' for DEVICE/Direct Record Control. 
DCB address is the address of the associated DCB. 

Word 1 



F3 is the control specification (0 means no format 
control or no direct record control; I means for- 
mat control or direct record control). 

CHECK CORRESPONDENCE OF DCB ASSIGNMENTS 

CORRES The CORRES system call provides the user's 

program with a means of determining if two open DCBs have 
been assigned to the same physical device or file. If the 
assignment of the two DCBs are equal, register 8 is returned 
with a value of 1. If any error is found in the DCBs while 
processing the CAL, if the assignments are found to be un- 
equal, or if either DCB is not OPEN, a zero is returned. 

The CORRES function call is of the form 

CAM, 1 address 

where address points to word of the FPT shown below. 

word ~" 



Code 



o i mrrn 



DCB] oddress 



DC 02 oddress 



4 I 2 51* i 6 ?ll f ic 11I12 1: 14 15' 16 IT II 1*1 20 21 22 2j';« 2; 2c 2-178 fr X 

where 

WordO 

Code is X'2B' for the CORRES function. 

DCB] address is the address of the first DCB that is 

to be checked for assignment correspondence with 
DCB 2 . 

Word 1 

DC&2 address is the address of the second DCB that 

is to be checked for assignment correspondence 
with DCB,. 



ASSIGN 



(Formerly Set Device/File/Oplb Index) 



This service call is used to modify the I/O medium in the 
specified DCB. The DCB being modified must be closed. No 
action will be taken if the DCBisopen. When an I/O medium 
may be identified by either EBCDIC name or system table 
index, the EBCDIC name is used If the size of the DCB per- 
mits. If the size of the DCB is too small to allow the spe- 
cified assignment by either nameor index, the service returns 
an error, without changing the DCB. 

When used in conjunction with the DEVICE (File Mode and 
Format Control) service call, this function provides the 
ability to dynamically assign a DCB to a file, device, or 
operational label. 

Calls for this function are of the form 

CAL 1,1 address 
where address points to word of the FPT shown below. 

word 



X'08' 



1 0- 



DCB address 



)\* i t ill ■ 10 III 12 I] 14 15 1 16 17 >l l»l 2C 21 22 23 1 24 23 26 27 1 21 2* 30 3 



word 1 



F M 



I ' l '} 'l l i i i > ll » 18 HHi '13' M » l u 1 ? I I » l » i l B g l ?4 2l It 2V l .ll • /> JU S 

optional (PI) 



Error address 



i a ]U i * Mi t it iil n is u ' u l it i> h wHm a is l }4 1> t. Hilt y n i 



optional (P2) 



I » 10 111 12 13 U lit 1* l>"ll H I 20 31 22 23 1 24 15 It 27 1 21 2» X 31 



1 2 ill S « 7 It » 10 111 12 i'5 14 15 



Operational label 



17 ii i«!k ii 22 isl 24 25 It Zjlit 21 X 3 
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optionol (P3) 



Device name oddress 



optional (P4) 



opi 

i 



Area and filename address 



1 1 j '4 j t 1 li ' k nlu u u is!* 1; ■• i»l» ii b bif 23 it iilji Hk) 
optional (PI 4) 



account name address 



I I J 1 1 4 5 i ? I I » 10 III 12 13 U ul U> I? II l»l» 2) V 2)1 14 21 16 pljt » B J 

where 

WordO 



X'08' specifies the ASSIGN call . 

DCB address is the address of the associated OCB. 

Word 1 



P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

P. is the operational label parameter presence in- 
dicator (0 means absent; 1 means present and the 
specified DCB will be assigned to an operational 
label). 



P- is the device name address parameter presence 
indicator (0 means absent; 1 meons present and the 
specified DCB will be assigned directly to a de- 
vice). 



P . is the area and file name address parameter pres- 
ence indicator (0 means absent; 1 means present 
and the specified DCB will be assigned to a RAD 
file). 



14 



is the account name address parameter presence 
indicator (0 means absent; 1 means present). 



Parameter bits (P2, P3, and P4) are scanned in left to right 
order and the first nonzero bit terminates the scan (i.e., 
other nonzero bits are ignored). 

Word Options 

Error address is the address of the entry to the 
user's routine that will handle error and abnormal 
conditions. 



Operational label is the operational label to which 
the DCB will be assigned in bits 16-31 in EBCDIC. 



Device name oddress is the address of a two-word 
data block that contains the name of the device to 
which the DCB will be assigned. The device name 
is in EBCDIC, left-justified (i.e., CRA03). 

Area and filename address is the address of a three- 
word data block that contains the area and file name 
to which the DCB will be assigned. The first word 
contains the area name in bits 16-31 in EBCDIC. 
The second and third words contain the file name 
in EBCDIC, left-justified with trailing bionics. 

account name address is the oddress of a two-word 
data block that contains the account name in 
EBCDIC, extended to eight characters with trailing 
blanks. 

The ASSIGN service does not provide defaults for area and 
account names. It inserts only what is requested. 



6ETASN (formerly Get Device/File/Oplb Name) 

This service call is used to obtain the device, file, or oper- 
ational label name to which the specified DCB is assigned 
and information about the device/file. 

The call for this function is of the form 

CAL, 1 address 

where address points to word of the FPT shown below. 

Note that if the requested optional parameter is not appli- 
cable, the post word (s) will not change. For example, if 
the call requests a file name to be posted but the DCB is 
assigned to a device, then the area and file name data 
block will not be modified. 

The DCB need not already be open, but will be left open 
on completion. 

word 



X'09' 



1 0- 



DCB address 



01 t J I* 3 t 7 l« t 10 n!ij ii w til» i> it 1+I20 Ji ii 23)24 is it b\n b k ; 
word 1 



5 



• I 2 ill J I 7 I I • 10 111 13 13 14 15I W 17 it 4ll0 JI 22 b! 24 25 2* 7>tH J» X 3 

optional (PI) 



Error oddress 



! 1 i 1I4 s 4 Ml I U Ii!i2 13 u'lilu i> it Htii 3: b iiti-h it iMS irsri 
optional (P2) 



Operational label 



01 2 ll' 5 I 7 It » W III 13 l5 U lilu 17 li 4l»4fk 23 2]l24232e27l»3VX3 

Opt ion 1 (P3) 



Device name address 



I' i » i ll > 1 >li > i b 11 1 15 n u'u l u jf u wl i m a a l »4 a s> gl H » » J 
optional (P4) 



Area and file name oddress 



8 * I I ill 1 I ?l l « k 1 1 I 13 n u'u l u l> I I W l » h » U l li is It »lM X 16 3 
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optional (P5) t 



Model number address 



l i } ll< $ t j\» « M iim} U U Isllt M li i*l Id II J} Ul|» Is J. SJll, H % \ 

optional (P6) 



File BOT 



II ) i\t t t 7 ll » ii nlii u L tjln i> « liljo }i i: bl* 2j » i?l 



M 2» » 31 



optional (P7) 



File EOT 



I I 1 J l< 5 • 7 11 » K 111 12 13 U Ijlw I? It l"ljC 21 22 J3I24 i; 2e rl» J» 30 3 

optional (P8) 



* 0- 



J 1 2 J l< 5 « 7 It 5 10 III 12 12 u 13! u 17 It l»ljc 21 22 u!;< 2s h J7|« 2 s Jc 3 

optionol (Pll) 



RSZ/GSZ 



1 I jU ! . r 1 1 » it nli; 13 u uli« u u nix 31 h n!!« li 3* Pin jj SB 5 






ptional (PI 2) 








* 


Device Index 


1 




10 11 


li U U W >t l> 11 MX V 


» Jill* B 5t JTHl » K ,, 



optional (PI 4) 



account name address 



61 i i I 4 i t 7 I I t 10 III 12 13 1* 15 1 I* 17 It wljO 21 22 23I24 23 26 27 1 21 79 30 11 



optional (P15) 



Write protect code 



1 2 1 1 4 3 t 7 ll » 10 111 12 13 14 111 » 17 II l«l>0 21 23 Zllu li it t>\£ H U : 



optional' (P16) 



DISC constants address 



1 2 lit 3 t 7 U ( 10 III 1! I] 14 15 1 It 17 II t»lx 21 22 nl» 23 It Hilt 14 J6 i 

where 

WordO 

X'09 1 is the code that specifies GETASN call . 

DCB address is the address of the associated DCB. 

Word I 



P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 

P. is the operational label parameter presence in- 
dicator (0 means absent; 1 means present). 

P_ Is the device name address parameter presence 
indicator (0 means absent; 1 means present). 

P. is the area and file name address parameter pres- 
ence indicator (0 means absent; 1 means present). 

P. is the model number address parameter (0 means 
absent; 1 means present). 



P- is the file BOT parameter presence indicator 

(0 means absent; 1 means present). 

P- it the file EOT parameter presence indicator 
(0 means absent; 1 means present). 

Pg is the file organization parameter presence indi- 
cator (0 means absent; I means present). 



r ll 



is the record size/granule size parameter pres- 
ence indicator (0 means absent; 1 means present). 



Pj2 •* rne device index parameter presence indi- 
cator (0 means absent; 1 means present). 

P. . is the account name address parameter presence 
indicator (0 means absent; 1 means present). 

P.. is the write protect code parameter presence 

indicator (0 means absent; I means present). 

P. , is the DISC constants address parameter pres- 
ence indicator (0 means absent; 1 means present). 

Word Options 

Error address is the address of the entry to the user's 
routine that will handle error and abnormal conditions. 

Operational label is the word wherein the system 
will post the name of the operational label to 
which the DCB is assigned. The operational label 
name will be posted in bits 16-31 in EBCDIC. 

Device name address is the address of a two-word 
data block wherein the system will post the device 
name in EBCDIC, left-justified. If the specified 
DCB is assigned to a disk file or to an operational 
label which, in turn, is assigned to a disk file, 
the address of the disk containing the file will be 
posted. 

Area and file name oddress is the address of a three- 
word data block wherein the system will post the 
area and file name. The area name is posted in 
the first word of the data block in bits 16-31 in 
EBCDIC. The file name is posted in the second 
and third words of the data block, left-adjusted 
with trailing blanks. 

Model number address is the address wherein the 
system will post the device model number in 
EBCDIC (i.e., 7446). If the DCB is assigned either 
directly or indirectly to a disk file, the model 
number of the disk containing the file wi*U be posted. 

File BOT is the word wherein the system will post 
the beginning sector number of the file to which 
the specified DCB is assigned. The sector number 
is relative to the start of the disk. If the DCB is 
assigned to an area (file name zero), the number 
of the first sector in the area will be posted in the 
BOT word. 
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File EOT it the word wherein the system will post 
the last sector number of the file to which the 
specified DCB is assigned. The sector number is 
relative to the start of the disk. If the DCB is as- 
signed to an area, the number of the last sector in 
the area will be posted. 

ORG is the word wherein the system will post the 
file organization type: 

00 for unblocked 

01 for blocked 

10 for compressed 

RSZ/GSZ is the word wherein the system will post 
the record size or granule size of a disk file. 
Granule size will be posted if the file is a random 
access file; otherwise the record size will be 
posted. 

Device Index is the word wherein the system will 
post the device index. 

account name address is the address of a two word 
data block to contain the account name in EBCDIC, 
extended to eight characters with trailing blanks. 

Write Protect Code is the word wherein the system 
will post the write protection code for the file's 
area. 

where 



word 1 



ii 



I'l'l'll- i . VII » U lllii li U UlU If U itlJMI JJ Uti.'fa IttflH » 36 i 
optional (PI) , 



STO address 



I I 1 i l t i . >1 1 ♦ H II I It l i It ' Wit i f. J HUt )■ ii » l ;> ii i. Hit * x 3 



opt 


ional (P2) 










I 


n * 


End-action address/no. 


u 




V 


t 1 


2 3 1 « i t 7 1 » 


v it n 


12 1} M 


■Si 


It 1? It l»l» 21 22 23124 2b 7© 3712* 7? X 3' 



optional (P3) 



Time 



i i i i l l i . ; n i n n li ; » u » l u i) ii l ine i\ b »u» a u b' h » » 1 



where 



WordO 



Code 



= X'12' forSIO. 
= X'13' forTIO. 
= X'M' for TDV. 
= X'15' for HJO. 



DOD = 00 if DCB address is given. 

= 01 if an operational label index is given. 
= 10 if a device index is given. 






is Public 


1 


is Background 


2 


is foreground 


3 


is System 


5 


isIOEX 



DISC Constants is the address of a three-word data 

block wherein the system will post the Tracks per 
Cylinder, Sectors per Track, and Words per Sector 
of the disk on which the file is allocated. 



DC B/OP/DE VICE contains the DCB address, oper- 
ational label index, or device index as specified. 



Word 1 



P. is the SIO address parameter presence bit (0 



means absent; 1 means present). 



P is the end-action parameter presence bit (0 

means absent; 1 means present). 



I0EX IOEX calls (available to primary tasks only) are 

of the form 

CAL1,5 address 

where oddress points to word of the FPT shown below. 

word 



* Code -0° OD DCB/OP/DEVICE 



oi 2 JI4 s • >!i » 16 11I12 13 m uli. i> w iMx Ji 51 b!» is 'it W* » x. 11 



P_ is the time-out presence bit (0 means absent; 
1 means present). 



F Q = 1 specifies that I/O is to be allowed only if 
the device has been deactivated (i.e., marked 
"down"); this bit is for diagnostic-program use. 

= specifies that I/O is to be allowed only if 
the device has not been deactivated; normal 
program usage. 
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Word Option 

SIO address b the address of Hie IOP command 
double word and need be present only when the 
call is onSIO request. 

I, End-action address/no. I indicates the contents 
of the End-action oddress number field. 

Value indicates end-action address. 

Value I indicates interrupt number. 

Value 2 indicotes interrupt label. 

Value 3 indicates completion signal oddress. 



Time is the number of seconds before the SIO is 

considered timed out and is meaningful only for 
queued requests. An HIO will be performed fol- 
lowed by end-action if requested. If the time-out 
increment is zero or not present the SIO will not 
be timed out. 



-Condition code 3 is set and condition codes 1, 2, and 4 are 
reset if Hie IOEX code is assembled out or if the caller is 
a secondary task. If an error is detected during the CAL 
processing, no change is mode to the user's condition codes. 
CAL processing will be terminated and control will be trans- 
ferred to the BADCAL (TRAP50) processor. 

TlOand TDV instructions ore executed immediately and the 
condition codes and status ore returned as shown in Table 14. 

SIO and HIO instructions may or may not be executed im- 
mediately, depending on whether or not the device has been 
preempted. The DEVICE PREEMPTION and DIRECT I/O 
EXECUTION sections in this chopter describe device pre- 
emption and the effect it has on SIO and HIO requests. 

For IOEX function status returns on a device that is on 
IOEX device (preempted device and con be used by IOEX 
only), it is necessary to refer to the appropriate computer 
and device reference manuals. This is required because, for 
preempted devices, true hardware status and condition codes 
are returned and these may vary from machine to machine. 
The condition codes and status returned to the user are 
shown in Table 14. 





Tabl 


e 14. IOEX Function Status Returns 




Operation 


Major Status 


Condition Codes 


Register 8 


Register 9 


Queued Preempted 
IOEX Device 


SIO 


IOEX not present or 
caller is background. 


0010 0010 


Unchanged 


Unchanged 




Device is down (SIO 


1000 1000 


Unchanged 


Unchanged 




not accepted). 










Request accepted. 


0000 00-- f 


Current com- 
mand address 


X' 10000000' 




Other 


None 








HIO 


IOEX not present or 
caller is background. 


0010 0010 


Unchanged 


Unchanged 




Request accepted. 


0000 00— 


Current com- 
mand address 


X' 10000000' 




Other 


None — — 







TlOand 
TDV 


IOEX not present or 
caller is background. 


0010 0010 


Unchanged 


Unchanged 




Other 


None — - 








Dashes indict 
manuals shoul 


ate true hardware status am 
i be consulted to determine 


i condition codes returned. The appropriate computer and 
the meanings of the condition code settings and the conten 


device reference 
ts of the status 


register. 
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The command pain for an SIO operation are not checked for 
validity and therefore must be coded very carefully. The 
flags in the command pain maybe set according to the needs 
of the user, however, if device preemption is not being used 
and the lOEXrequest goes through the I/O queue, then the 
flags must always be set in such a way that only one inter- 
rupt occurs for the request. A recommended set of flogs for 
an SIO request with one command pair is: 



I OP Command 
Ooubleword Bit 


Function 


Bit State 


32 (DC) 


Data Chain 





33 (IZC) 


Interrupt at Zero Byte Count 





34 (CC) 


Command Chain 





35 (ICE) 


Interrupt at Channel End 


1 


36 (HTE) 


Halt on Transmission Error 


1 


37 (IUE) 


Interrupt on Unusual End 


1 


38 (SIL) 


Suppress Incorrect Length 


1 



39 (S) 



Skip 



If command chaining is to be used, bit 34 (CC) will be set 
and bit 35 (ICE) must be reset in all but the last command 
pair. 

When I/O interrupts occur as a result of IOEX (SIO only), 
end-action is initiated as requested in the FPT (see I/O 
END ACTION section in this chapter). 

STDLB This function call is used to acquire or release 
the specified resource for a job and/or change the assign- 
ment of an operational label. The call is available to both 
foreground and background users. It is an asynchronous ser- 
vice when the enqueue option is specified; it must be fol- 
lowed by a CHECK function if the no-wait option is re- 
quested. Primary users may not use the enqueue option 
with wait. 

The STDLB call is of the form 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'62' 



I 0- 



OPLB 



o I I iU i t >U'> io IH12 u u ii l U V It * \ k i< b HH.M fc g lHM to V 
word 1 



ST. 



o — c; 



;oo 



o-o 



( i } 1I4 5 4 Ml I 10 nlu u « ulu 17 >• i*ljf 21 22 falx is It »'a » x ji 



optional (PI) 










4 1 1 )l< s TTtt- 


_o 

10 nl 12 13 14 


Error address 

ulu 1' li l*l» JI 22 &lu 2J 16 Pll* 21 JO 21 



optional ( 


P2) 






















Operational label 

ii rflJo 21 H Jill, b i> »\h a £ J 



't'l i ih i 


TTTT 


TTT 


TTtiT 


1] 14 lslw 17 



optional (P3) 



Device name address 



i'i ni<i< tun ii i 12 j u ' um w u mat. a b\» ^ t. » i >. h *. 11 
optional (P4) 



Area and filename address 



It 2 J I" S 4 Ml V K III 12 1) u Iill4 !> li Wlii ll 22 fall. 1} i» frl 



optional (P9) 








I 


n 




« 


End action address/no. 




1 


2 3 U ] 4 7 ll 


• 10 It 


12 11 u 


Ijllt 17 II !•! JC 21 22 !}U« 25 2t 2' ! 2t r> X. i 



optional (P10) 



Type 



.PV ft 

Completion \\ 
n ! ■ : r r i 



J 1 IJ ! 1 Jll'ITJ ll!l! IJ'li Utfe H II »flt !l H Hffc B It rlH » JS Jl 1 

optional (PI 3) 



Time 



I I i lUi i )IM II Ii l U » U Uli4 W II HlK 2. H B i t. KM g l M » K i 

optional (PI 4) 



account name address 



1 2 2 14 3 4 7 ll f 10 111 U IJ U lil 14 1> II ItljC 21 22 TjIk 25 24 }?li» >> X 11 

where 

WordO 

X'62' is the code to call the STDLB function. 

OPLB is the name of the associated operational 
label in EBCDIC. 

Word 1 

P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 

P. is the operational label parameter presence in- 
dicator (0 means absent; 1 means present). 

P. is the device name address parameter presence 
indicator (0 means absent; 1 means present). 

P . is the area and file name address parameter 
presence indicator (0 means absent; 1 means 
present). 

Pp is the end-action parometer^presence indicator 
(0 means absent; 1 means present). 

P.q is the completion code parameter presence in- 



10 



dicator (0 means absent; 1 means present). 



P,« is the timeout value parameter presence indi 



13 



cator (0 means absent and no timeout will be done; 
1 means present and the CALwill be timed out). 
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'. . if the account name address parameter pretence 
indicator (0 means absent; 1 means present). 

r . is the enqueue option indicator (0 means do 
not enqueue on resource; 1 means enqueue on 
resource). 



F. is the release option indicator (0 means do not 
release a previously acquired resource; 1 means 
release a previously acquired resource). 

F~ indicates to wait for service to be completed 
prior to returning from the CAL. 

F_ = 1 is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 

Word Options 

Error address is the location to return to if immedi- 

ate errors are detected. 



Time is the maximum number of seconds that the 
requestor will wait for STDLB to complete its 
enqueue for the requestor. Ifnot specified or zero, 
STDLB will not time out the enqueue. 

account name address is the address of a two word 
data block that contains the account name in 
EBCDIC, extended to eight characters with trailing 
blanks. If the account name is numeric zero or oil 
blanks, it is assumed to be unspecified. 

Parameter presence indicators (P2, P3, and P4) are scanned 
in left to right order and the first nonzero indicator is the 
one used. If all three parameter presence indicators are 
zero, the operational label is assigned to the null device. 

The following defaults for area and account names apply: 

1 . If neither account name nor area name is specified, the 
calling task's account is used, and the area may be any 
public area. This provides the simplest specification, 
and the user need not be concerned with the possibility 
of name conflicts other than within his own account. 



Operational label is the operational label to which 
the OPLBwill be assigned in bits 16-31 in EBCDIC. 
If bits 16-31 are zero, the OPLB is assigned to the 
null device. 

Device name address is the address of a two-word 
data block that contains the name of the device 
to which the OPLBwill be assigned. The device 
name is in EBCDIC, left-justified (i.e., CRA03). 
If the two word data block is all zeros, the OPLB 
is assigned to the null device. 

Area and file Name Address is the address of a 
three-word data block that contains the area and 
file name to which the OPLB will be assigned. 
The first word contains the area name in bits 16-31 
in EBCDIC. The second and third words contain 
the file name in EBCDIC, left-justified with rriol- 
ing blanks. If the three word data block is all 
zeros, the OPLB is assigned to the null device. 

end-action is as follows (applies only if enqueue 

requested): 

I = 00 end-action is an address to BAL from 
STDLB post. 

1=01 interrupt address is to be triggered by 

post. 

1 = 10 interrupt label is to be triggered by post. 

Type Completion contains the code describing the 
disposition of the service, including any error 
codes. 

BUSY busy bit is set to 1 when the service call 
is initiated and reset to when the service is 
completed. 



2. If the account name is specified, but the area name is 
not, the file may be in any public area. This provides 
for area-independent file specification. 

3. If the area name is specified but the account name is 
not, the system account will be used. This case provides 
compatibility for code written before the oddition of 
file account names. 

ST0PI0,STARTI0 These calls are of the form 

CAL1,5 address 
where address points to word of the FPT shown below. 

word 



Code 



DCB/OP/DEVICE 
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word 1 (optional) (PO) 
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word 2 (optional) (P9) 



I 



End-action address/no. 
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where 

WordO 

code = X'10' for stop all system I/O. 

= X' 11 * for start all system I/O. * 

= X'OE' for stop all background I/O. 

= X'OF* for start all background I/O. 

= X'16' for deactivate (dedicate to diagnostic use) 
and abort all I/O. 

= X'17' for activate and allow new I/O. 
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PO - 1 if mora parameters follow and Indicates the 
presence of word 1. 

HIO = for no HIO; = 1 for HIO (abort active request). 

IOP, DEV =0,0 reserve entire control ler(s). 
= 0, 1 reserve device. 
= 1,0 reserve entire IOP. 

DOD = 00 DCB address is given. 

= 01 operational label index is given. 
= 10 device index is given. 

DCB/OP/DEV1CE contains the DCB address, oper- 
ational label index, or device index as specified. 



Word 1 



is the preemption address (end-action ) parameter 
presence indicator (0 mecns absent; 1 means pres- 
ent). A step all system I/O call with P = 1 means 



the device will be dedicated to IOEX. Po has no 
meaning except in a stop all system I/O call. 



Word 2 

I, End-action address/no. I indicates the contents 
of the End-action address number field. 

Value indicates end-action address. 

Value 1 indicates interrupt number. 

Value 2 indicates interrupt label. 

Value 3 indicates completion signal address. 

Condition code 3 is set and condition codes 1, 2, and 4 
are reset if any of these calls are made by a secondary 
task. 

All condition codes are reset if o normal return is made from 
the call but no change is made to the condition code if an 
error is encountered during the CAL processing. 
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5. USER-TASK SCHEDULING AND OPERATION 



SCHEDULING AND LOADMG PROGRAMS 

The Overlay Loader links one or more relocatable object 
modules to form a load module, which is an absolute rep- 
resentation of the program. The load module is created as 
a disk file and consists of a header and an absolute memory 
image of the various program segments. The load module 
header contains the program parameters used by the Root 
Loader for loading the program root. 



LOADING AND TERMINATING FOREGROUND 
SECONDARY TASKS 

Foreground secondary tasks are loaded into memory and pre- 
pared for execution through the use of the INIT system call 
or the INIT key-in. This process involves the following 
operations: 

1. The INIT service acquires the necessary control table 
entries to establish the new task in the system. The 
task is then placed in a CP-R dispatch queue and will 
begin execution in the task initialization run-time 
loader. 

2. When the task is scheduled for execution (in normal 
priority sequence) the run-time loader performs the 
following steps. 

• Acquires temporary work space from the Task Re- 
served Pages segment . 

• Opens the file containing the absolute lood mod- 
ule and reads the load module header. 

• Acquires memory for the root segments and reads 
them into memory. 

• Tests for segments that ore to be loaded with the 
root and loods them into memory. 

• Satisfies any Public Library requirements. 

• When the task is completely initialized in mem- 
ory the temporary work space is released and the 
original INIT service is posted as complete. 

• Control is then transferred to the task's normal en- 
try point unless the original INIT service requested 
the STOP option or the DEBUG option. 

• If the STOP option was requested the task is placed 
in a 'stopped' state awaiting a START service 
call at which time the tasks normal entry point 
will get control. 

• If the DEBUG option was requested the CP-R de- 
bug service will be given control. 



The ontire task initialization sequence is executed in the 
context of the task that is being loaded. Thus, multiple 
simultaneous task-looding operations may be ongoing in 
which case the tasks involved compete for system resources 
(CPU time, memory, etc.) based strictly on their priority. 

Secondary task termination may be effected by any of the 
following: 

• TERM service call (from the task itself). 
e EXTM service call (from any task). 

e EXTM key-in. 

e KJOB service call. 

• KJOB key-in. 

• Failure of the task to properly process an error or ab- 
normal condition from a service call or trap condition. 

Task termination takes place in the context of the termi- 
nating task. The process involves the following step. 

e Waiting for any ongoing I/O operation to complete. 

e Closing any open data files. 

e Releasing memory resources. 

e Releasing all internal system-task controls which has 
the effect of deleting the task from the system. 

e If the terminated task was the last task in a fob, the job 
will be deleted from the system (except for CP-R and 
background jobs). 



QUEUEING PRIMARY FOREGROUND PROGRAM 
RUN REQUESTS 

If the monitor contains the "run queuing" option, all RUN 
or INIT requests for primary load modules are placed in 
the Load Module Inventory Table and are given a priority. 
The priority can be supplied by the user; if absent, CP-R 
assigns the default (lowest) priority to the request. In 
addition, a sequence number is assigned to the request so 
that priority conflicts can be resolved. The priority and 
sequence determines the order in which the Foreground 
Root Loader, which is part of the CP-R Control Task, at- 
tempts to lood the primary foreground programs. Such 
queued requests remain in the queue until loading is ac- 
complished or until a release is issued. 
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LOADING AMD RELEASING PRIMARY 
FOREGROUND PROGRAMS 

Loading and initializing of a primary foreground program 
root is performed by the Foreground Root Loader, and in- 
volves the following steps: 

1. If the "run queuing" option has been assembled into 
the monitor, the program to be loaded is selected by 
priority, where priority conflicts are resolved on a 
first queued, first to be loaded basis. 

2. Opening the file containing the absolute load module. 

3. Building a Load Module Inventory Table entry that con- 
tains the program name, core memory to be used by the 
program (root and all segments), and the public libraries 
required by the program. 

4. Testing for required memory availability. If the "run 
queuing" option has not been assembled into the moni- 
tor and some portion of required foreground memory is 
busy, a message is typed, the Load Module Inventory 
Table entry is purged, and appropriate status is posted. 
If the "run queuing" option is in the monitor and some 
portion of required foreground memory is busy, a mes- 
sage is typed, but the entry remains in the table. If 
the foreground memory is not busy, the load process 
performs the following: 

e Loads the program root. 

e Transfers control to the program start address, 
taken from the lood module header, wherethe user 
program initializes itself (connects tasks to inter- 
rupts, conditions interrupts, etc.). When ini- 
tialization is completed, the user prog ram performs 
an EXIT function call. The EXIT function will 
recognize that initialization of a primary fore- 
ground program has been completed and will trans- 
fer control back to the CP-R Control Task (the 
EXIT call does not cause an exit from the Con- 
trol Task). 

Steps 1 to 4 above are then repeated for each program 
to be loaded. 

A primary foreground program root can be loaded by any of 
the following: 

IRUN control command 

IROV control command 

UNIT control command 

RUN key-in 

RUN system call from a foreground task 

IN IT system call 

INIT key-in 

Since the root loading occurs at the level of the CP-R 
Control Task, primary foreground programs making RUN 



calls must give up the CPU (EXIT) before the load can 
be accomplished. Primary tasks can request the trigger- 
ing of an interrupt at conclusion of the root load and 
initialization. 

Release of a primary foreground program is also performed at 
the CP-R Control Taskprioritythroughthefollowingsteps: 

1. Disarming all interrupts connected to tasks within the 
program. 

2. Closing any open DCBs within the program to cause 
I/O run-down in addition to closing data files. 

3. Purging the Load Module Inventory entry, which has 
the effect of marking the memory as not busy. 



Release of a foreground program occurs as a resultof either 
an RLS key-in, RLS system call, EXTM key-in, EXTM sys- 
tem call, KJOB key-in, or KJOB system call. 



LOADING AND EXECUTING BACKGROUND PROGRAMS 

The Task Initialization Run-time Loader also loads back- 
ground programs as specified by control commands in the 
background (ob stream at the background priority level. 
Upon completion of the load, control is transferred to a 
background program at its start address. The background 
program terminates execution with an EXIT or ABORT ser- 
vice call. After terminating a background program, CP-R 
resumes processing the control commands from the back- 
ground job stream. 



TASK CONTROL BLOCK (TCB] 

A Task Control Block must be associated with each centrally- 
connected primary task, and is used by the system to save 
the context of the interrupted task upon occurrence of the 
given task's interrupt. The TCB is in the user program 
(assembly language users must allocate and define their 
TCBs in the source code of their program). The FORTRAN 
compiler generates implicitly the TCBs needed for a real- 
time FORTRAN program. 

Secondary tasks need not allocate TCB space as CP-R auto- 
matically provides the table for them. 



PRIMARY TASK CONTROL BLOCK FORMAT 

The assembly language user must allocate a TCB in the 
source code for each centrally-connected primary task in 
the program. Each TCB begins on a doubleword bound- 
ary and has a length of 26 words. 
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The CP-R CONNECT function fills In the TCB. When 
completed, a TCB has the following form: 



The PCB is of the form 




1 

2 
3 

4 

5 

6 

7 

8 
9 

10 

• 

25 



Saved PSD 



Intermediate PSD to transfer to TCB + 4 with 
skeleton key 



STM,0 TCB+ 10 



BAL, R1 RBMSAVE 



Indicators 



Task ID 



PCB address 



TCB address 



PSD to transfer to task entry in proper state 
(mode, write key, etc.) 



16 words for register saving 



7'8 



14 15 



31 



where RBMSAVE is a system routine that saves the inter*- 
rupted task's context in the TCB of the interrupting task 
and transfers control to the start address of the interrupt- 
ing task. 

Users must never alter any portion of o TCB. 



PROGRAM CONTROL BLOCK (PCB] 

The Program Control Block contains the prog ram -associated 
parameters used by the CP-R system to provide service 
functions for the program. Every program, background and 
foreground, contains a PCB that is allocated and constructed 
by the Overlay Loader. 



The Program Control Block defines the user Temp Stack to 
be used by a program. It also contains a pointer to a list 
of the DCBs associated with a program. 

Since the Temp Stack is associated with the program rather 
than individual tasks, different tasks within a program 
should not use these stacks for data communication. Com- 
mon storage can be used for communication between tasks 
or between occurrences of a given task. 



KB FORMAT 

The PCB is built by the Overlay Loader from parameters 
specified on the IOLOAD control command. 
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where 



TSTACK Is the address of the current top of the 
user's Temp Stack. 

TSS indicates the size, in words, of the user's 
Temp Stack. 

OVLOAD is the address of the table used by the 
segment loader to manage the program overlays. 

Trap Control (bits 0-7) specifies how the various 
traps are to be handled. An explanation of these 
bits is given in the TRAP function description 
later in this chapter. 

TRAPADD is the address of the user's routine that 
processes the various traps. ^ 

■* 

MSLADD is the address of the M:SL DCB, which 
is used to load overlay segments. 

DCBTAB h the address of a table of names and ad- 
dresses of all of the user's DCBs. This table has 
the form shown below. 
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SSW contain* the user's sense switch settings. 

Bit 26 contains the setting of switch 1, etc. These 
switches con be set and reset by the user via the 
FORTRAN Library routines. 

DCBTAB Format 



OCBTAB 
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Total no. entries in tabl 
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where 



Cj-C8 indicates the EBCDIC name of the DCB, 
left-justified, with trailing blanks. 

DCBLOC is the absolute address of the first word 
location of the DCB. 



The size of the Temp Stack must be equal to or greater than 
the total number of temp cells required by the maximum 
number of nested routines using temporary storage; (i.e., if 
a FORTRAN routine needs 16 temp cells and it calls a 
routine that needs 19 cells, the total number of cells re- 
quired would be 35). The number of cells required for trap 
handling CALs is 22; the reentrant FORTRAN IV Library 
subroutines require 148 temp cells for each task. 

Primary tasks at different interrupt levels within the same 
program shore the program's Temp Stack, and allocation 
must be sufficient to accommodate the maximum number 
of tasks that could be enabled at one time. When an 
executing task exits, it must restore theTemp Stack pointer 
to its original condition. This is particularly important 
in a primary foreground program where a Temp Stack is al- 
located for each program and not each task. Thus, if sev- 
eral tasks in the same program share the program's Temp Stack, 
the housekeeping of the Temp Stack pointer (e.g., sym- 
metrical pushes and pulls) must be meficulous. 



CP-R TEMP STACK 

The CP-R Temp Stack is a "push-down/pull-up" stack of 
memory locations that have been allocated by the Overlay 
Looder. It is required for all service functions. The CP-R 
Temp Stuck is reserved for the exclusive use of the monitor; 
users may not manipulate the stack since the stack pointer 
doubleword resides within the monitor in protected memory. 

The size requirement of the CP-R Temp Stack is a function of 
the particular monitor service being utilized. The worst- 
case requirement is approximately 150 words. The default 
size is 150 words. 



USER TEMP STACK 

The user Temp Stack is a "push-down/pull-up" stack 
of memory locations that have been allocated by the 
Overloy Looder. It is required for user-coded trap con- 
trol and subroutines that use Temp Stack storage (i.e., 
reentrant FORTRAN IV Library routines). 

The user can manipulate the Temp Stack by push/pull stack 
instructions (PSW, PLW, PSM, MSP)rhat symbolically refer- 
ence the external symbol U:PCB within their program (the 
Overlay Loader will satisfy the REF to U:PCB when the 
user's program is linked). The first doubleword of the Pro- 
gram Control Block is the stack pointer doubleword used in 
allocating (pushing) and releasing (pulling) blocks within 
the user Temp Stack. 

The "push-down/pull -up" functions operate on a last-in, 
first-out basis, and these operations must be symmetrical in 
number andsize. An attempt to push a blockthat is greater 
than the remaining stack space results in overflow. Simi- 
larly, an attempt to pull more out of the Temp Stack than 
had been previously pushed down would result in underflow. 
These conditions result in -traps that may be handled by the 
user (see TRAP system call). 



MASTER AND SLAVE MODES 

Both primary and secondary foreground tasks can change their 
execution mode through MASTER and SLAVE system function 
calls. At entry to a primary task, the mode is set as speci- 
fied by the function call that caused the connection. 

For secondary tasks the operating mode at entry is slave 
mode and mapped. Secondary tasks are given master- 
protected Mode, Mapped, by the MASTER system call. 

Note; Serious consequences can result from improper oper- 
ation in master mode. Secondary tasks must never 
operate in unmapped mode. 

1 

OVERLAY SEGMENT OPERATIONS 

Primary tasks control the loading of overlay segments through 
the SEGLOAD system call by explicitly naming the de- 
tired segment, by number. Background programs thot have 
been linked with the Simplified Memory Management (SMM) 
option may also use the SEGLOAD call. 
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Secondary foreground tasks control their segment activity 
through the use of CP-R memory management service calls 
described in o later chapter. 



TRAP HANDLING 

CP-R provides standard processing of trap conditions. A user 
can either take advantage of the system processing or re- 
quest that he himself handle certain trap conditions. Also, 
certain traps can be ignored. System trap handling involves 
aborting the task that is act! ve at the occurrence of a trap, 
with the following exceptions: 

1. An unimplemented instruction trap occurrence will re- 
sult in the instruction being simulated if the simulation 
package is in the system. If simulation is impossible, 
the task will be aborted. 

2. The user can mask out fixed-point arithmetic and deci- 
mal arithmetic traps either through system call (TRAP 
or JTRAP function) or at primary-task connection time 
(CONNECT, ARM, DISARM functions). 

3. The user can mask out some floating-point trap occur- 
rences through use of the LCF and LCFI instruction. 

4. Any unmasked trap can be received by the active pro- 
gram. This is set up through the TRAP or JTRAP func- 
tion call, wherein the user can specify the address of 
a routine to handle the various trap conditions. This 
address is kept on a per program or per job basis as 
opposed to a per task basis. 

When the user trap routine receives control, the following 
items are stored in sequence in o 19-word block of the 
program's Temp Stack, starting on a doubleword boundary: 
the PSD and the 16 registers saved when the trap occurred, 
and a word containing the trap location (right-justified). 
Register 1 points to word (first word of the PSD) in this 
block. If 19 words are not available in the user Temp Stack, 
the task is aborted. 

The address of the user trap routine and the control bit for 
each trap is kept in the PCB and the JCB (Job Control 
Block, see Appendix H). 

User trap handling or system trap handling is also in- 
voked if an invalid parameter exists in an FPT for a sys- 
tem call that is unable to post the error condition. In 
this case, a code of X'50' will be posted in the last word 
of the user's Temp Stack if a user trap address is present 
in the PCB or JCB. 

If the user has requested break control via the INT service 
call, the user Temp Stack will be set as described above and 
an X'51' code will be posted in the last word of the users 
Temp Stack before control is transferred to the user's break 
control routine. 

Return from the user trap routine to the interrupted program 
is accomplished by the TRTN and TRTY function, which re- 
stores the context from the Temp Stack and returns to the 
location following the trapped instruction or to the trapped 
instruction itself, respectively. 



CALHANOUNG 

Memory locations X'48', X'49', X'4A', and X'4B' are the 
respective trap locations for the CAL1, CAL2, CAL3, and 
CAL4 instructions. CAL1 instructions are reserved for moni- 
tor services, but the CAL2, CAL3, and CAL4 trap locations 
may be connected (centrally or directly) too user-defined 
routine by means of the CONNECT function call. User CAL 
service routines must reside in primary (unmapped) load mod- 
ules, even when they are intended for use by secondary tasks. 

Centrally connected CAL routines will be entered in the 
caller's map mode. The calling task's context (registers and 
PSD) is saved in the calling task's user Temp Stack. In addi- 
tion, register will contain the address of the caller's user 
stack control doubleword. Since centrally connected CAL 
service routines are entered in the map mode of the caller, 
but reside in unmapped memory, they must be in a one-to- 
one mapped area of any secondary task which uses them. 
Possibilities ore the memory between the end of the monitor 
and the start of secondary task memory(X'6000')oran active 
fixed segment of the second or/ task. Centrally connected 
CAL routines return to the calling task via the CALRTN 
function call. 

Directly connected CAL service routines are responsible for 
saving and restoring the calling task's context. They are 
entered unmapped. If they do not need access to the memory 
of the colling task, they need not be concerned with map 
mode or memory residence. If they need to access the mem- 
ory of a secondary caller, however, they must not only reside 
in one-to-one mapped memory for the caller, they must also 
determine that they were called from a mapped context and 
set map mode for their own execution. 

When a CAL; is executed, the effect is immediate; that is, 
traps function more like BALs than interrupts, except that 
the environment is saved for centrally connected traps, but 
is not saved for traps that are directly connected. 

RETURN FUNCTIONS 

CP-R provides users with the following return functions: 

EXIT is used by background programs at the normal 
completion of a background program. EXIT is used 
by foreground programs when a centrally-connected 
primary task has concluded the processing of an in- 
terrupt. An Exit call from a primary task causes the 
system to restore the context of the interrupted task, 
clear and arm the highest priority active interrupt, 
and return to the point of interrupt. Secondary tasks 
should not use EXIT but should use STOP instead. 

ABORT is used by background programs to cause 
the system to abort the job containing the program. 
The system will abort the backgroung^program and 
type a message on the operator console (OC) that 
the job was aborted and give the address of the 
ABORT call. Unless an (ATTEND command was 
present in the background job, the system will read 
and ignore all records from the C device until the 
next I J OB card is encountered. If an ABORT call 
is made from a foreground program, the program 
will be terminated. 
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STOP it used by both foreground and background 
secondary tasks when they wish to cease execu- 
tion and wait for a START call from another task. 

TERM may also be used by background programs at 

the normal completion of a background program. 
TERM is used by foreground programs to release 
and exit. 



INTERRUPT CONTROL 

CONNECTING AND DISCONNECTING PRIMARY 
TASKS TO INTERRUPTS 

Interrupt connection may be accomplished through use of 
the CONNECT function call and disconnection through the 
DISCONNECT function call . While these calls are usually 
made during foreground program initialization (performed 
at the Control Task priority level), this is not a require- 
ment. Connections may be made to any interrupt in the 
system except the clock pulse levels, the counter 4 equals 
zero level, the VO level and any levels defined at SYS- 
GEN for dispatchers, I/O deferral or remote communica- 
tions handling. However, tasks connected at a higher 
priority than the \/0 level con not request any I/O or any 
services which require I/O. A table of interrupts con- 
nected within a program is kept by the system. The table 
enables the foreground program release function to disarm 
and disable all interrupts associated with a foreground pro- 
gram. In calling for connection the user may specify the 
mode (master, slave) and the interrupt inhibit conditions 
that are to exist at entry to the specified task. Two types 
of connections are available, direct and central: 

1. Direct connection results in immediate entry to the task 
upon occurrence of the interrupt. The task must ensure 
that the context is saved, as necessary, and restored 
upon exit. Directly connected tasks may not use 
any CP-R services. 

2. Central connection results in entry to the task after the 
interrupted task context has been saved. The CON- 
NECT function constructs the TCB so that the con- 
text save will occur. Exit from a centrally connected 
task is by EXIT, which will restore the interrupted task 
status, arm and clear the highest priority active Inter- 
rupt, and return to the interrupted task. 

Central connection causes only register block zero to 
be saved, regardless of the block used in either the 
new or interrupted context. The user must provide 
register management if he uses other register blocks. 

To perform the connection, the system fills in the TCB 
previous ly shown. The PSD is constructed (TCB +8) to 
transfer control to the user in the proper mode and 
with the proper write key. An XPSD TCB instruc- 
tion is placed in the proper interrupt location to 
complete the connection. 



Details of the system calls concerned with connection 
are given later in this chapter under "System Function 
Call Formats". 



ARMING, DISARMING. ENABLING. AND DISABLING 

These functions can be performed by the ARM, DISARM, 
ENABLE, and DISABLE system function calls, which specify 
an interrupt by number or label. As options on ARM and 
DISARM, connection of the interrupt to a task can be per- 
formed, and/or a clock can be set to interrupt at specific 
intervals. 

ARM, DISARM, ENABLE, and DISABLE functions can also be 
performed by operator request through the CINT key-in. 



TRIGGERING OF INTERRUPTS 

An interrupt can be triggered through a TRIGGER system 
function call. The interrupt to be triggered is specified by 
number or by label. TRIGGER calls may be made from any 
foreground task. An interrupt can also be triggered by op- 
erator request through the CINT key-in. 



END-ACTION 

Primary tasks may use end-action. Two types of end-action 
are possible. 

1. The user provides an end-action address in the FPT. A 
transfer to this address will be made following the 
completion of the service. This end-action transfer is 
made by executing. 

BAL, 1 1 end-action address 

with the CPU in master mode, unmapped, and the post- 
ing level active. 

Return from the end-action routine must be made by 
B Ml 

It should be noted that since end-action may be per- 
formed with the posting level high, any task whose pri- 
ority is lower than that of the posting level is effec- 
tively disabled for the duration of the end-action. 

Since the end-action user can seriously degrade inter- 
rupt response for lower priority tasks, it is strongly 
recommended that this type of end-action not be used 
for applications where other techniques are satisfactory. 

2. The user FPT contains either an interrupt number or in- 
terrupt label sp ecifying a system interrupt. The system 
interrupt is triggered upon completion of the request. 
The task connected with the specified interrupt then 
performs the end-action function at the proper priority 
level. The user is responsible for connecting the inter- 
rupt and ensuring that it is armed and enabled. 
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The triggering service sets a flag in the TCB to indicate 
that the trigger has been performed. The EXIT routine in- 
terrogates this flog before performing the EXIT for centrally 
connected tasks. If the flag is set, the occurrence of the 
interrupt (previously lort by the triggering of on active in- 
terrupt) will be simulated. If more than one service com- 
pletion can occur while a task is active (or prior to such a 
task becoming active), the user is responsible for checking 
all possible reasons for which an interrupt may have oc- 
cured. (The flag bit in the TCB indicates one or more in- 
terrupt attempts. ) Directly connected tasks using this type 
of end-action must assume the responsibility for solving 
problems of this type since there is no TCB in which a flag 
bit can be set. 



word 1 



»■ i i ju i i m 



optional (PI) 



ii IJ U islu B ii 41 jo J, ti h!li is 5. #!i« }« J 3 



'J' I } II. 1 . 



Error address 

• » » iili? iJ l< lilw » H Wlfc ii 1} fali. J 5 j, Jj'ji J» x i' 



optional (P10) 



Type compl. 


n 




1 » i n 5 » •> 


• « t»lllui>Mulltiri(lflail2I2ll*231l]?lnj<i;]l 



1. 



SYSTEM FUNCTION CALL FORMATS 

The following system function calls should not be attempted 
unless the user has been given control as follows: 

The background or foreground program loader has trans- 
ferred control to the usjer* start address. 

2. The user's centrally-connected primary task has been 
given control upon the occurrence of the associated 
interrupt. 

In all of the FPT formats which follow, an asterisk in bit 
indicates that indirect addressing is permitted. That is, if 
bit contains a I, bits 15 through 31 contain the address 
of the parameter rather than the parameter itself. 

Whenever a return is made to an abnormal or error address, 
the error or abnormal code will be in byte of register 10 
and the address of the location following the call will be 
in register 8. 

Calls for which F3 (wait indicator) is not available are 
either immediate or synchronous. That is, control will 
never be returned to the caller until the service has been 
completed (See Appendix I for more detailed information). 
Primary task users should recognize that during any wait for 
completion of the service all lower priority tasks are blocked. 



optional (P11) 



Job name 

S 1 I i l l I I >l l I W 111 I J I) U UlU W I I H l KiTT TB l irg It g ! M !H 1 



optional (PI 2) 



Job name 



I I I Hi 



' tl I M I'Ul II U lilU » I I Wl B il B H l i4 ii h 1 ll » » 18 i 



where 

WordO 



X'64' is the code for the KJOB call. 



Word 1 

P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 



P.. is the type completion parameter presence in- 
dicator (0 means absent; 1 means present). 

P||/Pj. are the optional jobname-parameter pres- 
ence indicators and are set to ones if a full eight- 
character job name is supplied. 



If an error is detected in the call and no error address is 
available, the situation will be handled similar to a trap 
and the user will be aborted unless he has elected to do 
his own trap handling. 



F_ is the abort override indicator. If set, control 
will be returned to calling instruction +1 if errors 
are detected and no error address parameter has 
been provided. 



KJOB This function calf is available only to foreground 

and terminates a job by terminating every task in the job 
and deleting the job controls. KJOB has the format 

CAL1,7 address 

where address points to word of the FPT shown below. 



Word options 

Error address (optional) Is the locatiomto return to 
if errors are detected (see word 3 description for 
completion codes). 

Type compl. is set by CAL processing. 



word 



X'W 



iTTTlTTTT 



1 0- 



■ t w ulu ii u isiit 17 it i+i to ii a tjii. a it s\a m a jY 



Job name ii a four- or eight-character EBCDIC job 
name, left-j usti fied ond blank filled. If omitted, 
the caller's job is terminated. 
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SJOB This function call is available only to foreground 

and creates a foreground job by setting up job controls and 
building a job control block. SJOB is an immediate service 
that uses a standard FPT. It does not initiate any task with in 
the job; instead, RUN or INITmust be used following SJOB 
to start a task. It has the format 

CAM, 7 address 

where address points to word of the FPT shown below 



P. . is the optional account and name parameter 
presence indicator (0 means absent; 1 means pres- 
ent) if omitted the callers account and name are 
used 

F-, is the abort override indicator. If set, control 

will be returned to calling instruction + 1 if errors 
are detected and no error address parameter has 
been provided. 



word 



X'63' 



1 0- 



i I S J U s t rll i n nh: n u uU 17 it n\x 2i 22 z>\u 25 » s\n r> x> j 

word 1 



1 I ill 5 I 7 ll I 10 IIIU I] U IS I 16 17 II 1tl» 21 » 13 1 24 to 3» »l» V 3D 3 

optional (PI) 



Error address 



i 1 i 1 U 5 » 711 • 10 nl u i] m is! it 17 n nix 21 22 a\u 25 » 27I21 it x ji 
optional (P10) 



Type compl. 


n n 


U u 


1 2 3 l» 5 » 7 


• t 10 III 13 13 U isl 16 17 l» l»lx 21 3} 3uIm to 3> 7jlj« 2» X 31 



Required (PI 1) 



Job name 



1 I 3 1U 5 . >ll * K II 1 12 13 14 15 1 16 17 II l4lj6 ll U. Jjlj4 33 it Bill H H II 

optional (PI 2) 



Job nofnc 



& i 2 i U s * ? I. 9 w ill 12 n u iil»* r? ii tvt jo 21 h fali* x u r\j» 39 x si 

optional (PI 4) 



- account name address 



4 1 i )U 1 t t\i » ii 11I 12 n u ijlis 17 it i+Ijo 21 b UIm is it 27I31 » jo 3 

where 

Word 



X'63' 'is the code for an SJOB call. 

Word I 

P. is the error address parameter presence indica- 
tor (0 means absent; 1 means present). 

P ln is the type completion parameter presence ?n- 



10 



dicator (0 means absent; 1 means present). 



'.- is the optional jobname-parameter presence in- 
dicator and is set to one if a full eight-character 
job name is supplied. 



Word options 

Error address (optional ) is the location to return to 
if errors are detected (see word 3 description for 
completion codes). 

Type Compl. is set by CAL processing. 

Job name ia s four- or eight-character EBCDIC job 
name, left-justified and blank filled. This param- 
eter is required. 

Account and name address is the address of a five 
word data block that contains the account and name 
to be associated with the JOB. The format of the 
data block is shown below. 



wordO 



k l 



A 2 



A 3 



A4 



t I J 1U s t 7 f » * 10 ill 12 13 11 ulit IJ it rfllo 3i 22 23I24 is it b\n kui 

word 1 



A 5 



A 7 



A 8 



I I J lU S » 7 ll » » III 12 13 M Ijllt 17 II »l» !l 22 23 1 74 2! 26 27l28 79 X 3! 

word 2 



N, 



N 2 



I } 1 IS i i 711 » W III 12 11 U ui It 17 II wl 20 21 27 23124 23 26 27) 



N 3 



N 4 



i M 27121 2» X 31 



word 3 










N 5 

i i i ill i 


TT 


N 6 

I • W 111 12 13 U IS 


N 7 

16 17 M »llC 21 22 J3 


N 8 

24 25 26 27l2l 2» X 31 



word 4 










No 


NlO 


N„ 


N ]2 


6 1 2 3 I4 s 


« 7- 


I « K III 12 13 14 IS 


K 17 11 n\x 21 22 23 


24 25 2t 2?l}» 29 K 31 



where 



A. are the EBCDIC characters naming the account. 

N. are the EBCDIC characters in the user name. 

If the account and/or the name information is zero or 
blanks the callers account and/or name will be used 
instead. 

The SJOB CAL processor will validate the account and 
name against the AI file and if they are not found, will 
return an error code of X'7B' for illegal or invalid oc- 
count or name. 



-#*• 
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SETNAME This function coll allows the user to give the 

name of a load module to be used for execution of a task. 
SETNAME has the format 

C>»L1,7 address 

where address points to word of the FPT shown below. 

word 



X'5V 



1 



e i ; 3 1 j j i Hi 'i » Ml 15 u u ulu ij » wis si b bIu h u »ls b x st 
word 1 



1 7 



0» 



» '! ' 5 ' 3 I ■! •* ! V t U VWll l H » U I j l U I? II WlB i l H glM B St Pl B W IViT 

optional (PI) 



Error address 



1 1 t il. 1 t >U * It'i l uii » ' is l it i> U t4 l fe ii H H l l. t i. fclil H it : 

required (P3) 



Task name 



t I i iU i t »U i it ll t ti ii u ti l i* \t il W l » ii »H l ii fe fciMa » k> it 
optional (P4) 



Task name 



required (P6) 



I Load module name 

» I i iU i * > l i » H n l i2 n u m I it 17 i» i»l» liaal>a» gl» " » » 



optional (P7) 



Load modu le name 

i i 3 U 5 « )li » io ulu 13 m i>li* 17 w »l» ;i p nlw a 16 plit w » "ji 



Zl 



optional (P10) 



Completion 
code 



rrntrrrT 
optional (PI 1) 



■ t 16 nlis u 14 iili» 1? n i*l» Ji a fain u a» sin n » >' 




I i ■« " 1 

Job name 

! 2 III ! I )ll M til 12 13 14 ttU 17 >* l*l» il to *>'*• li *» »!» » 16 il 



Word 1 



P. is the error address parameter presence indi- 
cator (0 means absent; 1 means present). 

P^ is the task name parameter indicator (0 means 
absent; 1 means present). Only used if eight- 
character task names are being given. 

?y is the load module name parameter indicator 
(0 means absent; 1 means present). Only used if 
eight-character load module names are given. 

P._ is the completion code parameter presence 
indicator (0 means absent; 1 means present). 

Pj i"P]2 OTe tne I * 5 norne parameter presence indi- 
cators (0 means absent; 1 means present). If four- 
character job names are given P] ] must be set. If 
eight-character job names are given both P] j and 
P|2 must be set. 

Fy = 1 is the abort override indicator. If set, con- 

trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word options 

Error address is the return address to process any 
detected errors. 



Task name is one or two words containing the 4 or 
8 character (EBCDIC) task name whose load mod- 
ule equivalence is to be established. This pa- 
rameter is required. 



Load module name is one or two words containing 
the 4 or 8 character (EBCDIC) load module name 
that will be used to load the task whose task name 
is being specified. If load module name is all 
blanks, then task name specifies a prior equiva- 
lence that will be deleted. 



Completion code indicates completion status of the 
function call. 



optional (PI 2) 



Job name 

I 2 i l « i 4 Ht * 10 "Il2 13 14 llU 17 II itltO 21 23 Hit* fa it B\* h a . 



where 

WordO 



X'51' is the code for the SETNAME call. 



Job name is one or two words containing the four- 
or eight-character (EBCDIC) job name* in which 
the specified task name/load module name equiva- 
lence is to be made. If Job name is not present 
the equivalence will take place in the caller's 
job. 



Tasks in progress ore not affected by load-module 
name changes. 
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RUN This function call isavoilableonly to the foreground 

and initiates a primary task in the CP-R fob. It hat the 
format 

CAL1,5 address 

where address points to word of the FPT shown below. 

wordO 



X'OC' 



Signal address 



I I 1 lit i t J I* » to 11I12 u uultt 17 i« itljoji iiHii. b k Itltt H 16 Ji 



word 1 



O I J I 



word 2 



Priority 



43 6 711 9 M 111 12 13 U 15 



Interrupt no./label 

n 17 ii tf l a ii i> H l ii ti It »\H k M i 



CI 



113 14 5 



ll I I > 



C2 



I f W 111 12 13 14 15 



C3 



C4 



u 17 ii i4l3o ]i ii hht h it iMH X W ) 



word 3 



C5 



t 1 J 1L 5 » 7 



C6 



I » » 111 13 13 U 13 



C7 



14 17 II «!« }l 23 Hi 



C8 



6 if invalid attempt has been made to load a 
public library. Since public libraries are 
automatically loaded and released by the 
Foreground Root Loader, they cannot be 
loaded via a RJN call. 

7 if no table space was available to load the 
load module header. The caller may reissue 
the call if desired. 

The signal address cannot be a register (addresses 
through F)and must be in the calling program's 
portion of memory. An invalid signal address re- 
sults in control being transferred to the System or 
User Trap Handler. 

The user should inspect the signal word upon re- 
turn from the CAL, since some of the signals (3,4, 
and 5) are posted immediately by the RU N processor. 

Note that an interrupt is triggered only if the RUN 
request is passed on to the Foreground Root Loader. 
That is, signals 3, 4, and 5 are returned immedi- 
ately by the RUN processor and, in this case, no 
interrupt is triggered. 

Alarms are output by the Foreground Root Loader 
for error conditions 1, 2, and 6. 



wh 



ere 



Word 1 



WordO 



X'OC 



is the code for the RUN call. 



Signal address is the address of a status word into 
which the system posts one of the following signals: 

if the program was successfully loaded. 

1 if the space was not available in the fore- 
ground-private memory area or if there was 
insufficient space in the Load Module In- 
ventory (LMI) table to make entries for the 
public libraries needed by the program. 

2 if the requested program did not exist in the 
FP area of the disk or if an I/O error oc- 
curred attempting to load the program. 

3 if the program is already loaded. 

4 if a previous request has been made to load 
the same program but the program is not yet 
loaded. In this case, the Foreground Root 
Loader is able to notify only the first re- 
quester when the program is loaded. 

5 if the space was not available in the Load 
Module Inventory (LMI)tablefor the requested 
program. 



I indicates the contents of the Interrupt number/ 
label field (0 for no interrupts; 1 for interrupt 
number; 2 for interrupt label). This interrupt is 
triggered by the Root Loader at the conclusion 
Successful or unsuccessful) of the root load and 
initialization. 

DBG causes the program to run under control of 

DEBUG. 

ISP inhibits all status posting after the attempt to 
load the program. 

PP specifies whether or not the priority of the RUN 
request is present in bit positions 5 through 11. If 
PP = 1, priority is present; if PP = 0, it is not 
present. 

Priority specifies the order in which the RUN re- 
quest will be processed. The highest priority is 0; 
the lowest priority is X*7F'. + 



Words 2-3 

C. are the characters in the name of the load 
module. The name is left-justified with trail- 
ing blanks. 
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RLS This function call (Release Primary Foreground Pro- 
gram) is available only to the foreground and releases a pri- 
mary task in the calling job. It has the format 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



X'OB' 



i I 2 ll< S * > I * f IS llll2 13 14 llllt 17 M l»lx> 21 22 22124 2S 2t 27I71 7» JO Jl 



word 1 



CI 



C2 



C3 



C4 



I 1 1 I 4 9 t 7 11 V W 111 U 13 u Ijl 16 17 H lfl» Jl 22 23 1 34 25 2t r\n 2T K )l 



word 2 



C5 



C6 



C7 



^^T™Ttj 1 • 711 I IB 111 13 b M 15IU T7 It TfljD 71 33 Z3124 B 3t 27ln Z* 3D 31 



C8 



where 



WordO 

X'OB' is the code for the RLS call. 

Words 1-2 

C. are the characters specifying the name of the 
program. The name is left-justified and filled 
with trailing blanks. An invalid name results in 
a return with no action taken by the system. 



INIT This function (initiate a new task) causes the named 

task to be read into memory and initiated. It has the format 

CAL1.7 address 

where address points to word of the FPT shown below. 

word 



X'48' 



I I ! lit J t Hl'l IB III!} IJ U ISlU ff II Wll Jl H BIW B li »!l 



Area name 



i 27121 If JO 31 



word 1 



0-0 



-Of. 



or. 



0', 



e ' i ' t 'i li i t ' HiVw'u l n ' u ' u u l u » u w i s » t t ' n \ u ' aVn \ » ' * ' ui- 
optional (PI) 



Error address 



» I i i l i I t Hi I H ll l li U li ' U l U t > I I W l M ii Hfl l h H It g l H * » 3 

required (P3) 



Task name 

4 1 J 1J4 1 t »ll » \t tilu 1) u iilU I' \i t+lli 5t » Jjlfc b it »lji H U i 



optional (P4) 



Task name 



I I 1 II. 1 . )IH» ll l lt II It U l U » U B l H II » H i lt fait 8 I HH It 3 

optional (P8) 



Priority 



I I I lU i 1 Hi t Ifli t iVM U"i»U t> it A \ H 3i b taU i, » v\h it k 



optional (P9) 



End-action address/no. 



6 I 2 3 1 4 5 « 7ll 9 10 11 1 12 13 14 13 1 IA 17 It ivlac 21 22 23I34 26 2» 2rt 

optional (P10) 



Type 

completion 



I 2 3 U i 6 'll ' 10 llll] I] 14 lsllt 17 II Iflx 21 22 22J24 2i 2t jrljt 2f 

optional (PI 1) 



Job name 



S I 2 1 L S t 7 ll t 10 11 1 12 13 14 lilu 17 II 1+1 70 21 22 23 1 24 25 2» I7I21 2+ : 

optional (PI 2) 



Job name 



t 1 1 i l l i t Hi ♦ It \\\\7 il t4 U l U » H iH»li 22 H i t. fa it El HM » ii 
optional (P13) 



Time interval 



i i J lU 5 t HI I ii lil 13 1) u islu i> 1. vllxii JJ HI* is it 9\H H « Ji 
optional (P14) 



account name address 



II J 3I4 S 4 Hi I U II 1 12 13 14 111 It 17 li 1* li± 21 2223l24li2<27l7i2<X3 

where 

WordO 

X'48' is the code to initiate the call. 

Area name is the optional EBCDIC name of a disk 
file area for the load module. If Area name is all 
zeros, the disk area is unspecified. 

Word 1 



P. is the error address parameter presence indicator 
(0 indicates absent; 1 indicates present). 

P . is the optional task name parameter presence in- 
dicator (0 indicates absent; 1 indicates present). 

P. is the priority parameter presence indicator 
(0 means absent; 1 means present). 

P_ is the end-action address parameter presence in- 
dicator (0 indicates absent; 1 indicates present). 
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it th« type completion code parameter presence 
indicator (0 means absent; 1 means present). 



P.. -P. ? are the job name parameter presence indi- 
cators (0 means absent; 1 means present). 

P., rs the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 

P. . is the account name address parameter presence 
indicator (0 means absent; 1 means present). 

F„ is the delete on post indicator and signifies that 
no check will be performed. 



F,=0 



execute after load. 
= 1 leave in suspended (STOP)state after load. 



F-=0 task being initiated is primary. 
= 1 task being initiated is secondary. 

F_ wait for the task to be initiated before returning 
from CAL. Wait may be specified from secondary 



tasks only. 



F 4 =0 
= 1 



F 5=° 
=1 



normal initiation. 

initiate under DEBUG control. 

normal initiation. 

task is to be time-sliced. 



F 7 =1 



is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word options 

Error address is the return address for errors. 

Task name is the name of the task to be loaded and 
initialized. It will be converted to a load module 
name by lookup in the Job Program Table (JPT). A 
nonmatch defaults to the task name being used for 
the load module name (required). 

t 

Priority indicates the priority that is to be given to 
the task being initiated. Priority is a four-digit 
hexadecimal number the leftmost two digits repre- 
sent the CP-R dispatcher interrupt numberminus 
X'4F', the rightmost two digits represent a CP-R 
software priority in the range X'O' - X'EF'. The 
default priority is the caller's priority. 

I, End-action address/no. I indicates the contents 
of the End-action address/number field. End- 
action is allowed only for primary foreground tasks. 

M) indicates an end-action address. 
=1 indicates on interrupt number. 
=2 indicates on interrupt operational label. 



Type completion and BUSY indicate status of an 
initiate service. An initiate service is complete 
when the load module has been loaded and task 
controls established. 

BUSY=0 indicates service is complete. 

= 1 indicates service is incomplete. 

Job name is the four- or eight-character name of 
a job in which the task should be initiated. The 
caller's job is the default name. 

Time interval is the maximum number of timer units 
allowed for the task initiation and loading. If no 
time interval is specified the service will not be 
timed out. 

account name address is the address of a two-word 
data block that contains the account name in 
EBCDIC, filled to eight characters with trailing 
blanks. If the account name is all blanks or numeric 
zero, it is assumed to be unspecified. 

The default area and account names forlNIT differ from those 
of the other services, to provide compatibility to previous 
behavior. 

1. If neither account nor area name is specified, area FP 
with a null account name is assumed, to provide back- 
ward compatibility. 

2. If the account name is specified but the area name is 
not, the file may be in any public area. (This is the 
some default as for other services. ) 

3. If the area name is specified but the account name is 
not, the system account name will be used. (This is the 
same default as for other services. ) 



SCHEO This function (periodically schedule a task) causes 
an INIT call to be issued to a named task. It has the format: 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'68' 



6 I 1 3 U 9 



1 0- 



Area name 



I 4 9 « > '• * 10 III 13 13 M is! It W II it 1 16 31 32 J3l24 is it 77 !iS 29 X Jl 



word 1 


































r, 





P 3 


"-■ 


0-0 


\ 





t> 


"u 


fe 


"a 


fc 


fc 




f 2 








F J 


F 6 


F 7 


*v "° 


T 


1 


} 


1 


4 5» 


i 


1 


t 


id 


11 


u 


1: 


M 


blu 17 it it la 31 22 ul» is 


J6 


V 


a 


j» 


K 


r 



optional (PI) 




n n 


Error address 

15 1 14 17 II rtl» 21 23 h\u 29 34 J7I2I 39 X Jl 


u u 

( 1 3 4 1* s t Ml » 10 III 1] 13 14 



optional (P3) 



Task name 



13 3 14 5 



I 4 9 6 7 I I » 10 III 12 13 14 IS I 16 17 II If! 20 31 22 33 ! »« 39 26 77 1 M 2? X 1 
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optional (P4) 



Task name 



T' i J il« i » »U » ic nl 13 13 u isli* I 1 ii itlrf Ji H iilit is it »U* H it ) 
optional (P8) 



Priority 



i i J II. i « >li 4 ir. uhj ,3 i. i 5 | l6 i? it 4lji J, J}Bli« B J. JflM K U i 

optional (P10) 



Type 

completion 






1 I J \t i » 7 


■ » ic nb i2 ij m u lie i; it i»!k 2i }2 nlu 2s it ria »x n 



optional (Pll) 



Job ne 



D I 5 jU J i < It « IB ll!l} t! U I5tl» IJ II HlK JI H Blj« 1! It Bill » St 5 



optional (PI 2) 



Job 



name 



I } l l . } . 7 t . t It li l ia I) U t»U i ? il il l It ii » »H< }j >> p l H K It j 



opfional (P13) 






* 




i2al«j*7li* 


Time interval 

c n 1 u ri i4 iil to 17 ii wljc i 


> 22 23 1 2* ?5 2t> 77 1 M » X 3> 



optional (P14) 



account name adores 



» 'l i l U i » > l l I I B II 1 13 I ] u ' u l t. !■ I I H l M i l H H l i4 K it E t H W K 1 



optional (P15) 



Start time address 



B I } l l « i t Ml I H l i l i; Ii i/iMit i? il iHit ii 1) WU ii it » ! K H it V 

where 

WordO 

X'68' is the code to initiate the call. 

Area name is the optional EBCDIC name of a disk 
file area for the load module. See "account name 
address" description for default values. 

Word 1 

P. is the error address parameter presence indicator 

(0 indicates absent; 1 indicates present). 

P3-P4 are the task name parameter presence indi- 
cator (0 indicates absent; 1 indicates present). 

Pg rs the priority parameter presence indicator 
(0 means absent; 1 means present). 

P.q is the type completion code parameter presence 
indicator (0 means absent; 1 means present). 

P] ]-P)2 we the job name parameter presence indi- 
cators (0 means absent; 1 means present). 

P]3 is the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 



14 



15 



is the account name address parameter presence 
indicator (0 means absent; 1 means present). 

is the start time address parameter presence in- 
dicator (0 means absent; 1 means present). 



F« = task being scheduled is primary. 
= 1 task being scheduled is secondary. 

F- = normal initiation. 

= 1 task is to be time-sliced. 

F. = schedule the task. 

= 1 abort (delete) the scheduling. 

fy = 1 is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word options 

Error address is the return address for errors. 

Task name is the name of the task to be loaded and 
initialized. It will be converted to a load module 
name by lookup in the Job Program Table (JPT). A 
nonmatch defaults to the task name being used for 
the load module name. A nonexistent field defaults 
to the calling task. 



Priority indicates the priority that is to be given to 
the task being initiated. Priority is a four-digit 
hexadecimal number, the leftmost two digits repre- 
sent the CP-R dispatcher interrupt number minus X'4F', 
the rightmost two digits represent a CP-R software 
priority in the range X'0' - X'EF". The default 
priority is the caller's priority. 

Type completion indicates the type completion code 
returned by the SCHED call. 

Job name is the four- or eight-character name of a 
job in which the task should be initiated. The 
caller's job is the default name. 

Time interval is the period, in seconds, between 

successive INIT calls for the task. If the value is 
not an integral multiple of five, it is rounded up 
to the next higher integral multiple a&five. If this 
parameter is zero or absent, the task will be INITed 
once, at the specified start time. 

account name address is the address of a two-word 

data block that contains the account name in 
EBCDIC, filled to eight characters with trailing 
blanks. If the account name is all blanks or numeric 
zero, it is assumed to be unspecified. 
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The following defaults pertain to the combination* of disk 
area name and file account name: 

1. If neither account nor area name is specified, area FP 
with a null account name is assumed, to provide bock- 
ward compatibility. 

2. If the account name is specified but the area name is 
not, the file may be in any public area. (This is the 
same default as for other services. ) 

3. If the area name is specified but the account name is 
not, the system account name will be used. (This is the 
some defoult as for other services. ) 

Start time oddress is the address of a two-word block 

which contains the desired timeof the first issue of 
the 1NIT call. The start time block has the fol- 
lowing format: 

word 



year (whole year) 



month 



1 2 3 I 4 5 4 7 I I « UJ It! 12 13 w 15 1 14 17 II \l\x 21 23 23 1 2* 25 24 27 1 21 24 X 3 

word 1 



da/ hour 

1 I J SU ! 1 Ml » 15 Ml 15 U 14 I! 



minute 



14 i; ii nix ii b a 



second 



!4 Bit »m »» x 3 



Note that all fields are binary values in terms of 
calendar date/time; hour is military (0-23), and 
year is whole year, i.e., X'7C1' (1985). A special 
TIME call is provided, which returns date/time in 
the above format to facilitate date/time calcula- 
tions. Any field set to a -1 (all hexadecimal F's) 
will default to the present time (at issuance of 
CAL) for that field. 

If the start time parameter is absent or zero but the 
time interval is present, the task will be INITed 
periodically beginning at one period from the oc- 
currence of the SCHED CAL. 



IHT This function is used to establish BREAK control in 

the calling task's job. The call has the following format: 

CAL 1,8 address 

where address points to word of the FPT shown below: 



X'OE' 



Address 



I I 1 1 1 4 i i Ml I W l ll i) Ii h ' U l U 17 II H l M }i H H l li ii it f l H Bit i 

where 

X'OE' specifies the INT function. 

address is the address to which control will be 
transferred when a BREAK function is received for 
the caller's job. If this field is zero, any pre- 
vious BREAK control will be removed. 



Note that the user-stack arrangement of registers and PSD 
is identical to that used for the TRAP service calls. The 
Trap Retry (TRTY) call is used to return from the BREAK 
control processing routine, since the interrupted instruc- 
tion is not executed before the interrupt occurs. 

PC This function is used ro set the prompt character for 
the job. The default is no prompt. The call has the follow- | 
ing format: 

CAL 1,1 address I 

where address points to word of the FPT shown below: 



X*2C' 



Character 



I ] ] I 4 5 • 7 ll t 10 111 II 13 14 isll6 l> ll ItliC 21 22 13IU 25 2* hi 21 24 X 

where 

X'2C' is the code for the PC call. 

character is the prompt character to be output when 
an input request is received for the terminal. Il- 
legal EBCDIC characters and lower case ANSGI 
characters are not oliowed. 

EXTM This external task termination function allows one 

task to terminate another. It has the format 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'49' 



i 1 J 1)4 S * Mil W 111 12 13 14 lil 14 V> II Iflx 21 fa fal« 25 it Ulil H U 31 

word 1 



p 

1 





r 
i 


p 

4 




n 


r 
ii 


P 

13 




f 

1 





f 

7 


u u 


U U 


1 


1 


1 


i 


4 i t Mi 


♦ 


M 


11 


i! ii u bin i) ll i4lji ti ±2 Sili* 


25 


it Hit tt x 


31 



optional (PI) 



Error address 



4 I 1 JI4 i ♦ Mi I it 11I12 11 u'iJU I? it tflitii ii iili. is 2* 5MH J* So . 
optional (P3) 



Task name 



t 1 i 1I4 5 > Mi 4 it I1I12 13 U till* \t it Itlfc i. 22 falfcfc 24 i?li4 H ic 3 

optional (P4) 



Task name 



t 1 2 1 1 4 5 I Ml » » 111 U 13 14 15 1 14 17 II I'llt. 2' 22 23! 24 25 !» 27 1 2« 2» X 1 



optionol (P10) 



Type 
completion 



U i 4" 717 ' ♦ "A" 111 12 li U ull4 17 II lilac 21 22 23 1 2* 25 14 fIti J» * 4 



3 



optional (PI 1) 



Job name 

i i iU i 4 ?l i > i n u li i n » u l u i> ii w l «m b »l» b k 



ZJ 
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optional (P12) 



optional (PI) 



Job name 



i i i i l i i i ni i ii i i i n h u i i l u b i i wi Bi i n mu g n gli m r ji 
where 

WordO 

X'49' it the code for the EXTM call . 

Word 1 

Pi is the presence indicator for the error address 
parameter (1 indicates present; indicates absent). 

P3-P4 are the presence indicators for the task name 
parameters (1 indicates present; indicates absent). 

Piq is the presence indicator for the type completion 

code parameter (1 indicates the type completion 
code is to be posted; indicates no posting). 

P| 1 — Pl2 ore Tne presence indicators for the job 
name parameters (1 indicates a job name is speci- 
fied; indicates a job name is not specified). 

F] is the abnormal termination request (0 means do 
not abort the task; 1 means abort the task). 

fj=] is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 

Options 

Error address is the return location if errors are 
found. 

Task name is the name of the load module for the 
task to be terminated . The caller's load module 
name is the default name. All tasks in the same load 
module are terminated. 

Type completion set by CAL process table. 

Job name is the name of the job in which the named 
task is being executed. The caller's job is the 
default name. 



SIGNAL Send data to another task. This function call 

allows a task to communicate and post data to another 
task. It has the format 

CAL1,7 address 

where address points to word of the FPT shown below: 

word 



X'43' 



TTtn-TT 



1 0- 



t ' ♦ It n l li 13 u til >. i> 14 rilX i. h U \ it fa V » \ x » x 3 



word 1 



r*r 



t • n 11 



ii ii m i'il u U it n\x 21 23 33 



UTTSTF 



K>— 
STTF 



Error address 



I I 1 JI4 i I ? Ii t ii iilii 13 m 15I1* 17 11 it! jo 21 22 «1« is h z?\ie 
required (P3) 



Task name 



« I } Ih J . 7 ll I It nil! u u 15 1 14 17 i4 rill) »i ii JjIm a it pi it 2. 30 : 



optional (P4) 



Task name 



I I 3 1 4 5 6 7 ll » HI 111 12 13 u IS I M 17 It »l» 21 22 v\}t ?J 26 2? be 25 

optional (P5) 



Class 



I 2 3 1 4 5 6 7 It t 10 11 ! 12 U w 15 It* 17 II It! 20 21 22 &\u 25 26 27 1 26 2* 30 

optional (P6) 



Signal data area 



t I 1 1U i . >U ♦ H il l 12 Ii U It l * 17 It It l iotl H H l 24 lih H I 21 H 30 21 

optional (P7) 



Length 



Feedback data area 



'&' I J"Jt« IT » PI t iTlflli — 7 isf« 17 it lil20 il U Ull4 25 k 27lM >9 io 

optional (P8) 



Priority 



t i 2 il< i 4 Hi * Mi III 12 u U Iilu » Ii Itljbii ii iil» ait 27I21 S» 30 

optional (P9) 



End-action 



I I 3 1 4 3 ♦ i ll t W Illl7 11 14 islu 17 1| »lj0 21 27 23 1 » 15 24 rl» 29 30 31 

optional (P10) 



Type compl. 



Completion status 



I 2 ill 5 4 J it t l6 III 12 li 14 lillt 17 II »ljO 21 21 2jl>4 25 26 27 1 2* K 30 1 

optional (PI 1) 



Job name 



4 i i 3I4 i 4 'It t ii ulu 12 u 15I14 17 ii Wlio 21 ii HIJ4 !i 2* 27l2t »» x 3 

optional (PI 2) 



Job name 



i 1 J 3 1 4 5 4 7 It ' 10 111 12 11 14 Ijl I* 1? II It 1 70 21 22 o\u 25 26 lAlt 2» JO 3 

optional (P13) 1 



Time interval 



i I 2 lU 5 I 7ll t li lllli 13 14 13 1>4 ,V HTIIjO 21 22 Ill24 25 26 27l» 2t 30 31 



where 



WordO 

X'43' specifies the SIGNAL call. 
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r 5 
»o 



Word 1 

Pi is the error oddress parameter presence Indicator 

(0 means absent; 1 means present). 

?j is the task name (second word) parameter presence 
indicator (0 means absent; 1 means present), 

is the class parameter presence indicator (0 means 
absent; 1 means present). 

is the data area address parameter presenct in- 
dicator (0 means absent; 1 means present). 

Py is the feedback data area address parameter 
presence indicator. 

Pg is the priority parameter presence indicator 

(0 means absent; 1 means present). 

Pp is the end-action parameter presence indicator 
(0 means absent; 1 means present). 

Pjq is the type completion parameter presence 
(0 means absent; 1 means present). 

Pj ]~Pj2 are rne i OD name parameter presence in- 
dicators (0 means absent; 1 means present). 

P,g is the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 

F„ is the delete on post indicator. Indicates that 
no check will be performed. 

F Q =1 is the long wait indicator. If set, the calling 
task will be made a prime candidate for rollout. 

F_ is the wait indicator. If set to 1, the calling 
task will wait for a post of the SIGNAL service. 

F7=l is the abort override indicator. If set, con- 

trol will be returned to calling instruction + 1 if 
errors art detected and no error address parameter 
has been provided. 

Word options 

Error oddress on calls with wait, error address is 
the return for all error completions. On calls 
without wait error is the return address for im- 
mediate errors. 

Task name is the name of the task being signaled. 
Default is the caller's task. 

Class is o class bit mask. Default is X'FFFF'. 
Class is used to separate different types of signals 
to a signaled task. It is used in conjunction with 
a similar class bit mask supplied with the POLL 
service. The signal is only accepted if one or 
more one bits in the two class masks compare. 

Signal data area is the address of word of a data 
area to be made available to the signaled task. 
The data area format is as follows: 



word 2 (user defined area) 



word 1 



« i i i l j ! i > i i » ib n il } » u u l u n h w i s ; i g B i n k a v\ n » k if 
word n (user defined area) '. 



Length =n 



1 1 lit 



Reserved 



i i H) 111 u 13 M ul U 17 U 1*1 30 21 O hI» 25 h »li» * 30 31 



e i ; iu { i >i i i ib n i u 15 u u l u i > ii w i h }. ii a \ i. ii t. »m » m 

where length n is the number of words (from 1-127) in the 
data area. Short data areas are recommended. 

Length and feedback data area address the number 
of words and first word address of an area avail- 
able for receipt of any data sent by the signaled 
task at POST time. The area will be in the same 
format as the Signal data area above, with the 
number of data words returned given in the first 
byte. If the feedback area ?s smaller than the 
passed data area only the number of words speci- 
fied in this word of the SIGNAL FPT will be 
moved. The remainder of the data is lost. 

The feedback data is stored on return from a SIG- 
NAL with wait(F3=l)or upon return from aCHECK 
of a completed SIGNAL. 

If no feedback option is used, any passed data is 
discarded. 

Priority is the priority of the SIGNAL. Used on 
POLL's to control the order of input to the signaled 
task. Default is the caller's priority. 

I and End-action is the primary task end action op- 
tion, as follows: 

1=00 end action is an address for POST to BAL 
to. 

=01 interrupt address to be triggered by POST. 

=10 interrupt label to be triggered by POST. 

Type completion, BUSY, and Completion status: 

BUSY=1 if service is in process. 

=0 when the service is complete. 

Type completion and completion status is set by 
the signaled task. If the completion word is not 
provided, the type completion and completion 
status are not available to the signaling task. 

Job name is the four- or eight-character name of 
the job to which the signaled task belongs. De- 
fault is the caller's job. + 

Time is the maximum number of seconds to be al- 
lowed between the SIGNAL and completion of the 
service. If a time interval is not provided, the 
service will never be timed-out. 

The signaled task must exist at SIGNAL time. Standard 
CHECK calls are used with SIGNAL without wait. 
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POLL Request receipt of data from another task. This 
function call requests the input of the highest prior it/ SIG- 
NAL. It has the format: 

CAL1,7 address 

where address points to word of the FPT shown below. 

Word 



X'45" 



SIGNAL identification 



i i ; ill i i i ll ?. « i l l n u u u i i* » i i n i g i i h H l fc u % pI b y x i 



word 1 



0—0 5 



0—0 % 



l lU'J'i Ml '» '!! Tltli '13 WWC 17 Tl WlK !l H BlM'jl'ji'jTH » T 

optional (PI) 



Error address 



t I ! !lH I )ll I II UlU 1} U lilu i? it »(« J. H li\U 51 it »IH X K J 

optional (P5) 



Class mask 



i n im i iln « » l u » u itu i? ii »Ht }i h Hlv ;; it gi n » b 
optional (P7) 



Length 



Data area address 



6 i j ii/:' i ;'• « io nl i2 o u ulu i> Ii i+lio }i U MI24 is it 15!l» it ii 31 

optional (P9) 



I 



End-action 



a 1 J 3 1« 5 t 7 le » 10 11I12 13 u uIk 17 11 i»l» 21 22 n\n n *. 17I21 » x 31 
optional (P10) 



Type compl. 


■ 

u 
s 

V 


n n 




J 1 J 5I4 j * > 


i 


t » nlij i) 14 islw 17 >< »l» ji 22 nl» jj i6 jjln jt x 31 



optional (PI 3) 



Time Interval 



1 2 } 1 4 i t 7 I » « 10 nl 12 13 u 13 1 1« i7 it rtlje ?i 22 nl* 2j it 27I21 ?» jc 3 

where 

WordO 



X'45' specifies a POLL function. 

SIGNAL Identification stored by CP-R for subse- 
quent POST. 



Word 1 



P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 



P, is the class parameter presence indicator (Omeans 
absent; 1 means present). 

P 7 is the data area oddress and length parameter 
indicator (Omeans absent; 1 means present). 

Pp is the end action parameter presence indicator 
(0 means absent; 1 means present). 

Pjq is the type completion parameter indicator 
(0 means absent; I means present). 

is the time interval parameter presence indica- 
tor (Omeans absent; 1 means present). 



13 



Ffjr' h the long wait indicator; makes secondary 

task a prime candidate for roll-out. 

F2=1 immediate POLL only. If set, on attempt is 
mode to satisfy the POLL with a matching SIGNAL. 
If no match is found, an error code is returned and 
the service is completed. 

F3=l wait for SIGNAL. 

F_=1 Is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word options 

Error address is the location to return to if immedi- 
ate errors are detected. Used for all errors on 
POLL calls with wait. 

Class mask is a bit pattern for selective polling. 
The mask is logically ANDed with the class field 
in the signal. If the result contains all zero, the 
signal is not selected. Thedefault is X'FFFF'. 

Data area address ond length is the length and loca- 
cation of an area where any data attached to the 
signal will be stored. A maximum of 'length' words 
will be moved, the format of which follows: 



word 1 



Length =n 



T-TTTtTTTT 



Reserved 



I > H H i lt Ii U U l U » il H I 16 ii It H l i4 is k » 1 »t » a 3 



word 2 (Data from signaling task) 



TT !' )l< 1 • Ml I UmIij il u lili* iJ ti rflio i, H UIm k J. jjIm ; 

e 

word n (Data from signaling task) 



o i J il< i < 7I1 i » nlij 13 14 lilitV'i* itlic »i ij 23I34 25 it t>l» i» * 

The length in the data area is the actual length 
attached to the signal. (Length is from 1-127. ) 
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I and end-action is the primary talc and action as 
follows: 

1=00 end action is a BAL address to use when 
a SIGNAL is received. 

=01 interrupt address to be triggered when a 
SIGNAL is received. 

= 10 interrupt label to be triggered when a 
SIGNAL is received. 

Type completion and BUSY is as follows: 

BUSY=1 if service is in process. 

=0 if service is complete. 

Time interval is the maximum number of seconds al- 

lowed to satisfy the POLL. If no time is provided, 
the POLL will not be timed out. 

Standard CHECK calls are used with a POLL. The SIGNAL 
identifier in word is used by CP-R on the POST to locate 
the SIGNAL to be posted, and must be provided on the POST 
call by the signaled task. Subsequent POLLs will not cause 
the same SIGNAL to be delivered. 

When a SIGNAL occurs, the POLL call will be posted (but 
not the SIGNAL). If the level of the polling task is equal 
to or greater than the signaling task priority, the signal- 
ing task will be interrupted and the polling task dispatched. 

POST Posts the completion of a SIGNAL service. The 

function has the format 

CAL1,7 address 

where oddress points to word of the FPT shown below: 

word 



X'46' 



SIGNAL identification 

H io tlh: ij u is 1 1* i* li ttlii ii U bll* 25 fa »llt it jo 31 



word 1 



0-01 



oi i 3 lis t > 1 1 t ie ill 13 13 u is lu \i it itlii h h blu Is viUkxii 
optional (PI) 



Error address 



( I ] J Ij s t 7 li t m ulu i] u ulu 17 w itlji ii n fal» is It tola 1* k ji 
optional (P3) 



Task name 



t I J 1 it i t (It f io 11I12 u m isIm 17 k it Ik 21 a bIm is » p\n » 30 11 
optional (P4) 



Task name 

6 1 } 3 I* 5 6 7 It * K> 11 1 12 U M Ulu V II l»l>0 JI » »!*• 25 J» J?'" T> V 3 



optional ( 


P6) 









— 


Data area address 


6 i } J l« 


. ! 


ii ? 


IC 111)2 13 M 151 « 17 IB 19120 2\ 33 23174 25 26 27121 29 X JI 



optional (P10) 



Type compl. 



Completion status 



4" 1 J i"l * S t 711 » 10 111 12 li U nil* 17 li »l» 21 22 23 1 2' 25 26 v\x 2» X 3 

optional (PI 1) 



Job name 



o i 2 )l< s 6 'It « ic nl 12 u K isl it i? ii r?lx' Ji 22 hli. is i» iHh }• j6 3 

optional (PI 2) 



Job name 



1 3 3 I 4 5 t 7 I I f K III 12 1J I. isl M 17 It 1*1 JO 21 H Ulj4 ii ie bill 21 30 J 



where 



WordO 

X'46' specifies the POST function. 

SIGNAL identification specifies the SIGNAL to 
be posted and must be provided by the caller from 
the POLL service. 

Word 1 



P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 

P3-P4 are the task name parameter presence indi- 
cators (0 means absent; 1 means present). 

P, is the data area address parameter presence in- 
dicator (0 means absent; 1 means present). 

Piq is the type completion parameter presence in- 
dicator (0 means absent; 1 means present). 

r, ll" r> 12 are ^ e i°k "ome parameter presence indi- 
cators (0 means absent; 1 means present). 

£7=1 is the abort override indicator. If set, control 

will be returned to calling instruction + 1 if errors 
are detected and no error address parameter has 
been provided. 



Word options 



Error address Is the location to return on errors. 

Task name is the four- or eight-character name of 
the task to which SIGNAL was sent. Default is 
the caller's task. This option allows the user to 
SIGNAL task A, poll from task B, but post from 
another task, e.g., task C. 
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Data area address h rite location of feedback data. 
Data area format is at follows: 



word 1 



Length =n 



Reserved 



l'i I ll< It III M ulii ii * lilu l> it Itlfe J. U Blj* U k »tH t» U ii 

word 2 (Data to signaling talc 



8 i } 1 li i » 5 lo I io nl 12 u u is'.i« 17 11 i+lx 21 )i IiIm H k J*IH H U 

word n (Data to signaling task 



1 2 i I4 5 4 ? 1 1 5 10 11 ! ii o u is! i6 t7 it Mx »i 22 23I 



13114 25 M 27121 HI)i 



T5-JT- 



Length, in words, is from 1-127. 

Tvpe completion, BUSY and Completion status is as 
follows: 

On entry BUSY must be 0, meaning service 
complete. 

Type completion is the code to be posted in the 
signal and eventually back to the signaling tasks 
FPT type completion word. If the Type completion 
word is absent, a code of X'01' will be posted in 
the signal. 



Job name is the four- or eight -character name of 

the job in which the task in P3,4 resides. Default 
is the caller's job. Job name is not used if P3, P4 
are zero. 

POST is an immediate service and does not use CHECK calls. 
Users should avoid completion codes FO-FF which are used 
for special purposes by CP-R. 



EHQ Obtain the right to use a controlled item. The 

ENQ function allows tasks to gain exclusive or shared ac- 
cess to a controlled item. The item is user defined and 
could be a table, a piece of equipment, a file, or anything 
which for logical or physical reasons cannot be used by two 
tasks at the same time. The call has the format 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 













1 





n 


A*»f 


U 


1 i ill j » 7 

word 1 




» 





l 


10-0 


f 
1 


♦ 


t 


00 


• 

13 


f\ n 


r 

a 


f 

1 


f 

2 


'1' 


f 7 




V 


1 


i 


L il4 S J 


L T 


TT 




10 11 


11 


ii u ulit 17 u rtlii ii li li 


14 


Is 




H1H 


M to 11 



optional (PI) 



Error address 



1 1 i 1 1 . i 4 m > \i n i l) i i .4 ,i \ » \} <i w l » 1 11 }j ! ). » i. hihh« 
required (P3) 



Controlled item name 



• 1 2 J 1 4 3 4 7 li f n nl 11 ii 14 dI it 17 m wlic 21 22 n\u 2! j. rljj 



required (P4) 



Control item name 



• I 2 ] 14 S 4 7 ll » 10 111 I! I] 14 ijl 14 17 II It! JO 2! 13 n\ 14 25 26 2?l 7 

optional (P8) 



Priority 



» i ' il l i » ■ l i ■ w n il } ii u l i l u r ii w i s ; i b u l j. ji h y l g j> » 
optional (P9) 



I 



End-action 



» r> il l i i m i n n ti > it u mu i> n mm i b m i . b i> g ummf 
optional (P10) 



Type compl. 



I 2 1 I 4 i 4 7 I I 4 K> III 12 II 14 111 16 17 II l4 1 20 JI 2! 2ll24 75 24 27lil 

optional (P13) 



Time interval 



I i ll» 5 4 7 U 4 li III 1J I J 14 1)1 16 17 II !»!jC 21 11 2}lj4 25 26 7?l 21 24 JC 2 

where 

WordO 



X'4C' specifies the ENQ function. 



Word 1 



P is the error address parameter presence indicator 

(0 means absent; 1 means present). 



P is the priority parameter presence indicator 

(0 means absent; 1 means present). 



P is the end-oction parameter presence indicator 

(0 means absent; 1 means present). 

Pjq is the type completion parameter indicator 

(0 means absent; 1 means present). 



P]3 is the time interval parameter presence indi- 
cator (0 means absent; 1 means present). 
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F_ = 1 it a long waitoption making the task a prime 
candidate for roll -out. 

F. = 1 it a system level control led item. 
= it a job- level controlled item. 

F. - 1 is an immediate acquisition option. If the 

resource is not available the service returns to 
caller with an error. 

F« = 1 is the wait indicator for completion. 

F. = 1 is a shared acquisition. 
= is an exclusive acquisition. 

F_ = 1 is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word options 

Error oddress is the location to return to if immed- 

iate errors are detected. Also used on all errors 
on ENQ calls with wait option. 

Priority is the relative priority of the request, as a 
hardware and software priority. Default is the 
caller's priority level. Priority is used only when 
multiple ENQs are outstanding on a controlled item 
when it is DEQed. 



I and end action 
follows: 



is the primary task end action as 



I = 00 end action is a BAL address to use when 
the ENQ is posted. 

= 01 end action is an address to be triggered 
when the ENQ is posted. 

-10 end oction is a label to be triggered 
when the ENQ is posted. 

Type completion and BUSY is as follows: 

BUSY = 1 if service is in process. 
= if service is completed. 

Time interval is the maximum number of seconds that 
the caller will wait for the ENQ to be satisfied. If 
not specified, the ENQ will not be timed out. 

After a caller is given a normal type completion on an ENQ, 
he must DEQ or his acquisition will remain until his task 
terminates . 

Once a shared acquisition has been made, additional shared 
acquisitions will be allowed, while exclusive acquisitions 
will be queued awaiting a DEQ by all shared users. Once 
an exclusive ENQ has been queued, only higher priority 



shared ENQs will be allowed to acquire the device.' Exclusive 
acquisitions always cause all following ENQs to be queued 
for potting when the item is DEQed. Standard CHECK calls 
are used with ENQ. 



DEQ Release the right to use a controlled item. This 

function call allows the caller to release control of a pre- 
viously acquired controlled item, and has the format 

CAL1,7 oddress 

where address points to word Oof the FPT shown below: 

word 



X'4D' 



t i > ill s « 7 lit io ill n i] M ul 14 17 ii 1*1 k } H Hlj4 U k b\n n x i 



word 1 



6 i 1 i '« i ♦ Hi t \b nlii is u tslu \i it tflM i\ U Ulfc is k Bill n x 3 

optional (PI) 



Error oddress 



( i 1 lU i t Hi I it lilu IJ u islu l> ii i4lu> ii H bin is fc tflii » so j 



required (P3) 












TT! TlT s 1 . 


rrr 


Controlled item 

» W 111 12 13 14 tjlu 17 11 


name 

i*Ijo ii li fa 


Mis 26 27 


21 2» 30 31 



required (P4) 



Controlled item name 



i I 2 J U i t 7 l« » 10 lllu 13 14 ljl» 17 U rtljJO 21 22 Zjljl 23 J» pill H 30 3 



optional (P10) 



Type compt. 



1 I 1 ill 5 4 J U • li III 12 13 U Ijl 14 17 H (tIJC 31 23 23lj4 !5 2* "In 7» X 3 



where 



Word 

X'4D' specifies a DEQ call. 

Word 1 

P. it the error oddress parameter presence indica- 

tor (0 means absent; 1 means present). 

P ln is the type completion parameter presence in- 



10 



dicator (0 means absent; 1 means present). 



F.=l is a system level controlled item. 
=0 is a job level control led item. 
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F ? = 1 is the abort override Indicator. If set, 

control will be returned to calling instruction + 1 
if errors ore detected and no error address poiuin* 
eter has been provided. 



Word options 

Error address is the address to return to if errors 
art detected on the service call. 

Controlled item name is the eight-character name 
of the item being released. It must previously 
have been ENQed successful ly. 

Type completion contains the code describing the 
disposition of the service, including any error 
codes. 

DEQ is an immediate service and is not subject to CHECK. 
DEQ automatically posts the highest priority waiting ENQs 
which can be satisfied. 

TRAP This function call has the form 

CAL1,8 address 

where address points to word of the FPT shown below, 
word 



X'14' 



Trap address 



» 1 1 3 l« 5 t 7 It t X II 1 12 1J 14 Isll. 17 It l+l» 21 22 bllt 25 it b\H H 

word 1 



of 



I I 3 14 i » 7 It » 10 11113 13 U isll* 17 II If lid 21 22 J3IH IS it Ullt ll ■ )l 

Ignore 



Abort 
where 

WordO 



Trop 



Permit 



XM4' is the code for the TRAP call. 

Trap address is the address in the user program that 
receives the requested traps. The address is op- 
tional unless it is the initial call and one of the 
trap bits is set. The address must lie in the call- 
ing program's portion of memory. 



Bits 30-31 are the Ignore flags specifying that the 
decimal or arithmetic mask in the PSD is to be set 
so that these traps are ignored. 

The Abort, Trap, Permit, and Ipnore fields specify the 
changes to be made in the disposit ion of trap occorrenc es . 

The bits in these fields have the following significance: 

UA User Task Abort (X'50') 

WDG Watchdog Timer 

NAO Nona I lowed operation 

Ul Un implemented Instruction 

PS Pushdown stack limit 

FP Floating-point arithmetic 

DEC Decimal arithmetic 

FX Fixed-point arithmetic 

If a control bit has value 1, the trap is to be handled as 
specified. A value of zero specifies that no change is to 
be mode in the handling of that trap. The fields are pro- 
cessed from left to right (Abort, Trap, Permit, Ignore), 
with the last-processed code overriding any previously 
processed code. 

If a given trap condition has a control bit value of 1 in 
both the Abort and Trap fields, the Trap bit will over- 
ride the Abort bit and the user will receive the trap, 
since the Trap bit is the last one processed. 

JTRAP This function call allows the user to specify job 
level trap controls. The call has the format 

CAL1,7 address 

where address points to word of the FPT shown below 

word 



X'5D' 



Trap address 



( I i II* i t »ll • U hi 12 b uiiU It i*l iS ii JJ Uli. k it 0lH H ji 3 

word 1 



I ' I ' j 1 3 I. 1 j' t 1 '1 1't'ii iihj ii u i>li» i7 ii Hlit ii'tj'ijlj* fa it J>ljt it'x'H 
Abort Trap Permit Ignore 

where 



Word! 



WordO 



Bits 1-8 are the Abort flags specifying which traps 
ore to be handled by the system. 

Bits 9-16 are the Trap flags specifying which traps 
are to be handled by the user's trap handler. 

Bits 22-23 are the Permit flogs specifying that the 
decimal or arithmetic mask in the PSD is to be set 
so that these traps are permitted. 



X'5D' is the code for the JTRAP call. -J 

Trap address is the address of the user 'strap handler. 
The address is optional unless it is the initial call 
and one of the trap bits is set. The address must 
lie in the calling load module portion of memory 
and will be used for all traps from within the job. 
Separate trap addresses are maintained for primary 
and secondary tasks within a job. 



94 System Function Call Formats 



Word 1 

Bits 1-8 or* the Abort flags specifying which traps 
are to be handled by the system. 

Bits 9-16 are the Trap flags specifying which traps 
are to be handled by the user's trap handler. 

Bits 22-23 are the Permit flags specifying that the 
decimal or arithmetic mask in the PSD is to be set 
so that these traps are permitted. Note that the 
callers PSD is the only one affected. 

Bits 30-31 ore the Ignore flags specifying that the 

decimal or arithmetic mask in the PSD is to be set 
so that these traps are ignored. Note that the 
callers PSD is the only one affected. 

The Abort, Trap, Permit, and Ignore fields specify 
the changes to be made in the disposition of trap 
occurrences. 

The bits in these fields have the following significance: 

UA User abort 

WDG Watchdog Timer 

NAO Nonal lowed operation 

Ul Un implemented Instruction 

PS Pushdown stack limit 

FP Floating-point arithmetic 

DEC Decimal arithmetic 

FX Fixed-point arithmetic 



TRTY The trap retry function call is of the form 

CAL1,7 address 
where address points to word of the FPT shown below 
word 



X'5E' 



( I 1 ill 



5 6 7 I I » 



it n l i; II u U l U t> U H l M !: ii bH« ii it b \ it it x 



This function returns to the instruction that trapped for re- 
try. This con be used if the user feels he has corrected 
the problem in his trap handler. 



TEXIT The trap exit function call is of the form 

CAM, 7 address 
where address points to word of the FPT shown below 
word 



X'5F' 



t I i 3 1 4 i . J I I » W nl .2 ii u u I » i7 .1 HI it !i Ull> li V »\H 2* Jo 3 

This function performs an EXIT from within a trap handler 
routine. For secondary tasks, this will result in a STOP 
function. 



THTH This function call (trap return) is of the form 

CAL1,9 5 
No FPT is used. Return is to the trapped instruction + 1. 



If a control bit has value 1, the trap is to be handled 
as specified. A value of zero specifies that no change 
is to be mode in the handling of that trap. The fields 
are processed from left to right (Abort, Trap, Permit, 
Ignore), with the last-processed code overriding any 
previously processed code. 

If a given trap condition has a control bit value of 1 
in both the Abort and Trap fields, the Trap bit will 
override the Abort bit and the user will receive the 
trap, since the Trap bit is the last one processed. 

The user abort bit UA is used in conjunction with the 
other bits. If a condition occurs that causes an abort 
(such as a trap handled by the system) the user will 
get control after the error messages but before the 
abort sequence. This will allow him to try a re- 
covery procedure. The trap address (X'40 1 , X'4T, 
etc.) is placed in the top word of the user's task. 
The user abort will occur for all traps, incorrect calls 
(trap X'50'), and other major problems. If the user's 
recovery has been successful, he can continue exe- 
cution; if not, he can abort the trapped tasks. The 
user shall take care to determine that his recovery 
has been successful since CP-R will allow a return on 
an unsuccessful recovery. 



EXIT This function call is of the form 

CAL1,9 1 

No FPT is used. 

For secondary tasks this call causes termination, and for 
primaries it exits and clears the interrupt level. 



EXOA The Exit Disarmed function call, available to 
primary tasks only, has the form 

CAL1,9 X'A' 

No FPT is used. 

EXDA performs like an EXIT except that the primary task's 
interrupt is left in the disarmed state. .* 

* 

TERM This function call is of the form 

CAL1,9 8 

No FPT is used. If the call is given by a background 
program, control is returned to the Job Control Processor. 
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If the call is given by a foreground program, the program 
is terminated. 



ABORT This function call is of the form 

CAL1,9 3 
No FPT is used. 

CONNECT,ARM,DISARM,ulSCONNECT (Primary Task Crea- 

tion, Deletion, Start, and Stop) 

These functions connect a task to an interrupt level or a 
processing routine to a CAL2, 3, or 4; arm an interrupt 
level; disarm an interrupt level; or disconnect a task from 
an interrupt level or CAL processing routine. The task 
associated with the affected interrupt need not be in the 
same load module or job as the task executing the CAL. 
The calls have the format 

CAM, 5 address 

where address points to word of the FPT shown below. 

word 



optional (2 words) (P6 in word 0) 



Code 





5 


6 


p 

7 


00 


f 

7 


2 Int. addryiabel/CALoddr. 


1 J 3 I* 5 • ? 

word 1 


1 9 10 11 12 I J ul 


5 14 17 II l»! JO 21 22 »l» 15 34 »l» » 30 31 


r 
i 




p 
2 

i 


3 


I 


C 
I 


I 

I 

4 


t 

I 

7 


M 

s 
« 


D 

M 

9 


A 
M 

in 


NR 

„,♦_ , . 

Ill 12 13 u 


TCB address 

Jlle 17 II I»!tC 2i 22 2Z\U 25 20 27 1 n 2? JO 3: 



Note: Bit 3 of word 1 can be either AI or DE. 



optional (PI) 



Register block 



XPSD address/Start address 



8 1 i i l i ! i Mi T w ] \\ n 1 ) ii ' « 1 U ff II H ! K i i B H Hi 8 % U' H 9 ■ i 



optional (P2) 



MTW instruction/Clock value 



o I ! 5 I* ! 4 'Hl't K ii t li IS U 111 » V iTIUM JT 55 Tj!l« JS it 0lJ» ft So i' 

optional (P3) 



Error address 



1 I I 111 I 1 )lt I II nli! IJ U'lilu W II WlK 2', J5 Wit li k 7IM ft K J" 

optional (2 words) (P5 in word 0) 



Task name 



* i J lli 5 i Jll » it nli} u u ulit 15 il itljcii li Uli. li 1» Slit t» K 31 



Task name 



1 2 3 l« 5 • i li I it 11I 



11 1 12 13 u isi u 



u » 1. m& !■ Hhifa n t. gih * ic j 



Job name 



1 13 14 5 17 



It I 10 111 



10 11112 13 U 15114 17 1| 14120 21 22 23 1 24 35 24 27l» jo X 



Job name 



4 t ] S 1 4 i 4 Pit » li III 12 IJ 14 15 1 14 17 it it 1 24 21 U 23 1 24 IS 3t 2?l» » » 3 

optional (P7 in word 0) 



Type 

completion 



1 2 3 1 4 5 1 7 II f 10 II 1 12 13 14 111 14 17 II l»l» 31 J! 23l}4 JS 34 2?!m r> X 3 

where 

WordO 

Code X'03' specifies DISCONNECT or DISARM; 
X'04' specifies CONNECT or ARM. 

P_ is the Task name option presence indicator. 

P. is the Job name option presence indicator. 

P_ is the Type completion presence indicator. 

Ft=1 is the abort override indicator. If set, control 
will be returned to calling instruction + 1 if errors 
are detected and no error address parameter has 
been provided. 

I- indicates that the address 02 = u )» or *"• 'obe' 
02 = ')» of the interrupt is specified in Interrupt 
address/label. 

Int. addr./label/CAL addr. is the hexodecima I ad- 
dress for the interrupt or CAL. 

Label is the two-character EBCDIC name for a 
label. 



Word 1 



P. is the CONNECT and DISCONNECT indicator. 
If the service is CONNECT, PI also is the XPSD/ 
Start address parameter presence indicator. If 
P] = 1, a connection or disconnection is performed; 
if P] = 0, an ARM or DISARM is performed. Pj 
must = I if the address is that of aCAL2, 3, or 4. 

P_ is the MTW/elock value parameter presence in- 
dicator (0 means absent; 1 means present). 

P_ is the error address parameter presence indicator 
(0 means absent; 1 means present). 

AI* when connecting a CAL, indicates that the ad- 
dress increment option on a CAL is desired. In this 
t, the entry address will be the contents of the 



Bit 3 of word 1 can be either AI or DE . 
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R field from the CAL added to the user's start 
address. Therefore, the user must provide a 
16-word table of entry points at the start address 
on the basis of one per R value. 

OE when connecting an interrupt, specifies that 

the interrupt is to be disabled (DE = 1), or enabled 
(DE = 0). This parameter is only used on ARM 
and CONNECT to an interrupt. 

Dl specifies that the connection is to be direct 
(DI = l)or central (DI - 0). 

CI specifies that the task is to be entered with the 

clock group inhibit set (CI = 1) or reset (CI = 0). 

II specifies that the task is to be entered with the 
I/O group inhibit set (II = 1) or reset (II = 0). 

EI specifies that the task is to be entered with the 
external group inhibit set (EI = l)or reset (EI = 0). " 

MS specifies that the task is to be entered in 
master mode (MS = 0) or slave mode (MS = 1). 

DM specifies that the task is to be entered with 
the decimal mask set (DM = 1) or reset (DM = 0). 

AM specifies that the task is to be entered with the 
arithmetic mask set (AM = 1) or reset (AM = 0). 



specified. The specified register block pointer 
is in the PSD used to enter the task. The effect 
is the same as if the task executed LRP instruc- 
tions at entry and exit. The context saving and 
switching prior to task entry and afer the task 
EXITs is always executed using register block 
zero. 

XPSD/Start address if the task is directly con- 

nected, this word is the address of the XPSD 
instruction to be used to enter the task. The 
XPSD instruction furnished will be stored in the 
interrupt location by the CONNECT function. 
If the task is centrally connected, this word 
contains the start address of the primary task. 



MTW/Clock value is the value (in units of the 

clock's resolution) to which the clock is to be 
set in the case of a centrally connected counter- 
equals-zero interrupt. An MTW -1 instruction 
will be used to decrement the value furnished. 

For directly connected, counter-equals-zero in- 
terrupts, this word should contain the actual 
Modify and Test Word instruction which is to 
be stored in the corresponding count pulse lo- 
cation. For both types of connections, a clock 
parameter is required unless the interrupt is be- 
ing reconnected (i.e., is connected when the 
CAL is initiated). In this case, no change will 
be mode to the clock pulse interrupt location 
if P 2 = 0. 



NR Is the number of registers to be saved upon oc- 
currence of the interrupt (if connection is central). 
Value is used to denote that 16 registers are to 
be saved. Registers are saved beginning with reg- 
ister Oand at least four registers must be saved. If 
a task uses CALU, registers through R10 should be 
saved in case error exits cause R6 and R10 to be 
altered. 

TCB address contains the TCB address for central 
connection. For direct connection, this portion 
of word I is unused. For interrupt, the TCB 
should be 26 words long. Central CAL connec- 
tions need an eight-word TCB. The TCB address 
must be a double word address. 



Word Options 

Register block is the register block pointer to be 
used by the task when a central connection is 



Error address is the entry address to the user's error 
handling routine if the monitor encounters any 
error in processing the call and is unable to com- 
plete the requested function. If no error address 
is provided, 'trap 50* is simulated. Error address 
will be used for all returns but normal. A type 
completion option can be used to determine the 
exact error source. 

Task name is the name with which the task is to be 
associated, and must occupy two words. The task 
will use the PCB associated with the load module 
having this task name and will be terminated in a 
group with the other tasks using the task name and 
PCB (i.e., the other task connected into the load 
module). The caller's task is the default name. 
The connection will not be performed if the load 
module with the specified task name has not been 
loaded or is in termination. 

Job name is the name of the job in which the task 
resides and must occupy two words. The caller's 
job is the default name. 



"— t 



Bit 3 of word 1 can be either AI or DE. 



Type completion is the code describing the status 
of the service call. 
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Clock interrupt connecHom ore always to the counter- 
equals-zero interrupt. Interrupt address/lobe I cannot eon- 
tain a clock pulse level. Use of clock 4, CT, and HI inter- 
rupts is restricted and is to be used only by the monitor. 



On clock counter-equals-zero connects, theMTWis moved 
automatically to the clock pulse, or an MTW -1 is stored 
in the clock pulse and the clock value is stored in a fixed 
real memory location for the clock level (K:CLOCKI, 
K:CLOCK2, and K:CLOCK3). The values in K.-CLOCK1-3 
will be moved to the actual counter location (CLK1-3) on 
the central connection each time the task is entered, which 
will be via CLK1SAVE-CLK3SAVE. If a direct connection 
is used, the user must reset his counter. If a central con- 
nection with a clock value is used, the user need not per- 
form any resetting. 

Successful processing will return to the instruction following 
connect. If an error address is specified, all other comple- 
tions will exit to the error address. 



DISCONNECT frees the interrupt location, making the 
level available for any task. 



Parameters DI to TCB, X PSD/Start address, and MTW/Clock 
value are only used on CONNECT. DE is used on ARM and 
CONNECT. Interrupt label. Code and P] - P e flogs must 
always be provided. Error address. Task name, and Job 
name are options used by all services. These services are 
only available to foreground tasks. 



If the interrupt or CAL is connected when a CONNECT CAL 
is performed, the current connection must be to the same 
task as the new one being requested. 



The CALRTN function thou Id be used to exit from centrally 
connected CAL2, 3, and 4 processing. CALRTN will clean 
the user's Temp Stack of CAL linkage words. 



In direct connections, the CAL processing routine is respon- 
sible for allreentroncy and returning control to the caller. 



The format of the stack upon entry to centrally connected 
CAL processing routines is shown in Figure 6. TCBs for 
centrally connected CALs are shown in Figure 7. The con- 
dition codes at entry to centrally connected CALs contain 
the 'R' field from the CAL instruction. 



Previous top 
of stack r 






New top of 
stack ■- 


PSD Word , 




PSD Word 1 


RO 


R1 


(Registers 2 through 14) 


R15 









Figure 6. User Temp Stack Format at 
CAL Processor Entry 



Once a CONNECT or DISCONNECT is in progress from 
one task, a CONNECT or DISCONNECT from a higher 
priority task to the same interrupt is not allowed until the 
original one is complete. An error code will be given to 
the second caller chronologically. 



Once a CAL routine is connected, a call by any task will 
cause entry to the connected code. CAL processing will be 
done using the PCB and TCB of the calling task. If the CAL 
processor does CP-R service calls (CALls), CP-R will per- 
form the service for the original calling task. 



For example, if a CAL2 processing routine does a TERM, the 
calling task isterminated, not the CAL processing routine. 



EXIT will cause the caller to become idle. The user's 
CAL processor should clear the temp stack of the PSD 
and registers saved by the central CAL connection prior 
to the EXIT. 



TCB+0 
+1 

+2 
+3 

+4 
+5 
+6 
+7 






Saved PSD 




Intermediate PSD 
(Address = TCB+4) Disable 


STD, R0 CAL Registers 


BAL,R1 CALENTR** 


Entry PSD 







Figure 7. TCB for Centrally Connected CALs 
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CALRTN The CALRTN function call it used by centrally 

connected CAL2, 3, and 4 processing routines to return 
to the calling task at the instruction following the call. 
CALRTN has the format 

CAM, 7 address 

where address points to word of the FPT shown below. 

word 



X'60' 



• I 2 lN S 1 7 I I f 10 III 12 13 14 lil 16 l» II wl 20 21 22 23 1 M 25 M 27l2t 2» 20 3 

where X'60* is the code for the CALRTN call. 



ENABLE, DISABLEJRIGGER 
Commands) 



(Interrupt Controlling 



These function calls (available only to the foreground) are 
of the form 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



Code 



00 







C 1 2 3 I 4 J « 7 I I f 10 III 12 13 14 isl » 17 It »»1 » 21 23 h\u "Ji VJjIjV!* 30* 



Interrupt oddress/label 



( optional (PIT) 



Error address 



1 2 3 I 4 3 4 7 I I 9 10 111 12 13 14 13 1 16 17 II l»f 2C 21 32 23! 24 25 24 27 I h 24 46 3 

where 

Word 



Code = X'00' specifies trigger. 
= X'OV specifies disable. 
= X'02' specifies enable. 

P] ] is the Error address parameter presence indi- 
cator (0 means absent; 1 means present). 

U specifies that either the address (I2 = 0), or the 
label (I2 = 1), of the interrupt is specified in In- 
terrupt oddress/label. 

Interrupt address is the hexadecimal address of an 

interrupt. 

Label is a two-character EBCDIC name for a label. 

Word Option 

Error address is the entry address to the user's error 
handling routine if the monitor encounters any error 
in processing the call and is unable to complete the 



requested function. If no error address is provided, 
the monitor will process an ABORT return. 



START Begin executing a secondary task. This functior 
call removes a secondary task from idle state following a 
STOP call. The call has the form 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'4A' 



I 2 3 I 4 5 I 7 1 1 » 10 III 12 13 14 15 1 14 17 II I»l20 21 22 Till* 25 36 27*2E » X 3 

word I 







.0- 



I 'l ' i'l l l i l ' U '» H 'llll l 1 3 l i li l U 1 MI Wl » il B H l M U it gl H » Kir 

optional (PI) 



Error address 



8 i 3 3 1 < ■ i t Mi t i c m 1i ; hu isl u v ii w i n ; i b am b si rlw w x v 
required (P3) 



Task name 



8 I I l \ i I i Ml t It ll l i} 1 1 U H i lt B II WHtil T HIS Hi. gl Hg M if 



optional (P4) 



Task name 



t i i i li ! , mm h u i ii » u u i u i > i i wi n i i a a \ u a >> p i h * x y 
optional (P10) 



Type comp. 



M I lliil MM io TTt ii 'T i u ' uU ' B II rHic li 22 U t U ii ' 24 g l iVS g V 

optional (Pll) 



Job name 



»i i 3 1 , i t Ml » H li l ii 11 u U l U I ? U U l iUI H H l fats it »Hi« ji ii 
optional (P12) 



Job name 



] lit I i III I it 111 13 13 14 ulu 17 II 1+120 21 23 23l24 2! 21 27 1 21 It X )l 



where 



WordO 



X'4A' specifies the START function. 



Word 1 



P| is the error address parameter presence indi- 
cator (0 means absent, 1 means present). 
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P4 is the last name parameter presence indicator 
and is one if an eight-character task name is 
provided. 

Pjq is the type completion code parameter indica- 
tor (0 means absent; 1 means present). 

Pjj-P]2 ore the job name parameter presence indi- 
cators (0 means absent; 1 means present). 

F7 =1 is the abort override indicator. If set, con- 

trol will be returned to calling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 

Word Options 

Word options are the same as for STOP below. 



STOP Stop executing a secondary task. This function al- 
lows a secondary task to place itself or another task in a 
stopped state. It has the format 

CAM, 7 address 

where address points to word of the FPT shown below. 



Pq b the presence indicator for word 1 (0 means 
absent; 1 means present). If Pq =0 then the STOP 
applies to the calling task. 



Word 1 

P. is the error address parameter presence indica- 
tor (0 means absent; 1 means present). 

P3-P4 are the task name parameters presence indi- 
cators (0 means absent; 1 means present). 

Pjq is the type completion parameter presence in- 
dicator (0 means absent; I means present). 

P 1 1 ~P 1 2 are the job name parameter presence in- 
dicators (0 means absent; 1 means present). 

Fq=1 is the long wait indicator making the normal 
secondary task a prime candidate for roll-out. 



word 



X'4B' 



( 1 J il< 5 * Jli 1 » ic 11I12 i] ,4 ul« 1) it i»l» 21 U til« is It 27 lb a x : 

optional (Pq in word 0) 



r 
1 





T 
3 


4 





r 
10 


11 


r 
12 





F 






r 

7 




H 


t 




1 


4 s t i 1 1 


9 


10 


11 


12 13 U ul 1* 17 )• Ifl JO 21 22 23 


u 


a m 27I21 2» » 


31 



optional (PI) 



I I 3 14 5 • 7 

optional (P3) 



Error address 



I • 10 llll2 13 14 15! It 17 II IfljC 21 22 33I44 25 26 v\n 7* X 31 



Task name 



1 2 3 I 4 5 » 7 I • t W 111 13 13 M ul It 17 U »l 20 21 12 23 1* fa It Slit 2> II 1 

optional (P4) 



Task name 



I 2 3 I 41 i * 7 I I » K 111 12 13 14 «l M 17 It liljC 21 22 23 1 24 is it &\H H 30 3 

optional (P10) 



Type comp. 



> I i l i t i t ) l l t K 11 1 12 13 U llU l> II If l jO 21 bfl t » is it g t M» X 3 

optional (Pll) 



Job name 



t I i I t . i ' l > t » 4 tf ll l l? 13 M u l lt 17 it 1* 1 20 21 22 ij 1 24 23 it g l h Hi 

optional (PI 2) 



Job name 



r \ t lit i t Mi \ itMiniuiiUiUH l iHiii B l itii It 1> I H Hit i 
where 

WordO 

X'4B' specifies the STOP function. 



F7=l is the abort override indicator. If set, control 
will be returned to calling instruction + 1 if errors 
are detected and no error address parameter has 
been provided. 



Word Options 

Error address is the return address if errors are de- 
tected in service processing. 

Task name is the four- or eight-character name of 
the secondary task to be stopped. Default is the 
caller's task. 

Type completion is the completion code for the ser- 
vice including the error code, if any. 

Job name is the four- or eight-character name of 
the job in which the task resides. Default is the 
caller's job. 



STATUS,M0DIFY Obtain and modify task controls. 

STATUS U a function call that allows the calling task to 
obtain task control data. MODIFY is a function call that 
allows certain secondary task controls to be modified. The 
call has the form * 

CAM, 7 address 

where address points to word of the FPT shown below, 
word 



Code 


1 











• 


• 10 III 12 13 U ul It 17 14 til 20 21 22 23124 25 Jt n\lt 2» 30 31 
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word 1 



0-0 P « 



1 I 4 114 3 I 7 F 1 » W 111 IJ 13 14 lillt 17 II wljo 21 a xt\u IS 3* 2?ljl >» X 



optional (PI) 



Error address 



I I lllj ! Illl II llll! 1] U lilu 17 II llljt 51 » Hl3< B M flu 9* X 3 

optional (P3) 



Taste name 



i i i i u i > ; u i a n ii s 1 1 u ulu w u wl am a b I m b h g! » m » n 
optional (P4) 



Task name 



( I J iU J t 111 t IJ llli! 13 U til M i> il rflx ji 13 Uli- K It SlH » it 3 

optional (P8) 



Flogs 



Priority 



e i i 3U ; i ;l n n ti i ii i3 u ti l it i; ii wm i\ » » l t« b it y l mm 3 
optional (P10) 



Type compl. 



Completion status 



t I 2 3 I 4 5 t 7 I I ' K nil? 13 14 15 1 14 1? it itlfc I! 22 h\it is It Vlb it x . 

optional (PIT) 



Job name 



b i 2 3 1 4 ; t 7 1 1 I ii n l i; 13 u is l U 17 it ti l 3o ;i BU l it fa it ff t it H x 3 

optional (P12) 



Job name 



T 1 2 1 N 5 t 7 I I « 10 111 IJ 13 U li! it 17 It »\x 21 22 23 1 24 25 2* n\i% il X H 



optional (P14) 



account name address 



J I 3 i I 4 J « 7 I | 7 10 111 12 13 14 lillt 17 l» W 1 20 21 23 »! 24 25 H 27 lit » 30 3 



WordO 




Code = 


X'4E 


= 


X'4F 


Word 1 





specifies STATUS function, 
specifies MODIFY function. 



P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 

P3-P4 are the task name parameter presence indi- 
cators (0 means absent; 1 means present). 

P„ is the flags and priority parameter presence indi- 
cator (0 means absent; 1 means present). 



P.q is the type completion parameter presence in- 
dicator (0 means absent; 1 means present). 

r, 11~ r> 12 PTe rr,e I ' 3 n °me parameter presence in- 
dicators (0 means absent; 1 means present). 



14 



is the optional account name parameter pres- 
ence indicator (0 means absent; 1 means present). 



F ? =l is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors ore detected and no error address parameter 
has been provided. 



Word Options 

Error address is the location to return to if errors 
are detected in the service. 

Task name is the name of the task whose controls 
are being fetched or modified. Default is the 
caller's task. 

Flags are as follows: 

Bits Value Meaning 






I 


Task in final termination. 


1 


1 


Task connected to CAL2. 


2 


1 


Task connected to CAL3. 


3 


1 


Task connected to CAL4. 


4 


1 


Background task. 


5 


1 


Secondary task. 


6 


1 


Task being aborted. 


7 





Task initiated via RUN. 




1 


Task initiated via IN IT. 


B 


1 


Load to be performed. 


9 


1 


Public Library used by primary tasks. 


10 


1 


Public Library used by secondary tasks 


11 


1 


Release to be performed. 


12 


I 


Control sequence requested. 


13 


1 


Task is loaded. 


14 


1 


Task is run queued. 


15 


1 


Break control requested. 



Priority is the current task priority of the task as out- 
put from STATUS. On aMODJ/Y call, it is thepri- 
ority to which the caller wishes to change the task. 

Type completion is the completion code for the ser- 
vice, including error codes. 

Job name is the four- or eight-character name of 
the job to which the secondary task belongs. De- 
fault is the caller's job. 
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account name address it the address of a five word 
data block that will receive theoccount and name 
associated with the JOB. The format of this block 
h shown below. 



word 



A 2 



A3 



I I I III i i ill i a ill u i] u is! it it U HlX> }i H ftllt Is it »U» # Jo j 



word 1 








A 5 


A 6 


A7 


Afi 


t i lllut) 


I » W <lll2 II M 1J 


it i> \i i4l» 2i 2] n 


» n m p)» Din 



word 2 



N, 



N- 



N 3 



N 4 



I 1 1 li t ! t Ml » IB H i 1 3 I S 1 4 » > U I ? II W l K i l g HT h B It gl U » 1 8 I I 

word 3 



N 5 



N 6 



N 7 



N 8 



H I 1 ilt J't Ml » M uli} I) u lilw l> II rfljc 21 H Hlk }{ 1. }?lH H V i 

word 4 



N c 



i i i iu j » 



wh« 



N 



10 



I ■ 10 IU U 13 14 15 



Nil 



1* 17 II wl}( 21 1) li' 



N 12 

14 JJ It »!H 9 Jo 1 



A. ore the EBCDIC characters naming the account. 



N. ore the EBCDIC characters in the user name. 



A task whose priority is modified to a higher level ma/ not 
be capable of being dispatched at that level until the hard- 
ware interrupts drop back to the tasks previous level. This 
is the case if it was in execution when some higher priority 
interrupt caused it to be interrupted, ond the modify call 
was done at this higher level. 



If a STATUS call has Pj]-Pl2 Dut not p 3" p 4' rhe current 
task's status will be acquired, including the [ob name which 
will be stored in the Job name parameter. 



word 



Code 



• I » J 1 4 S t 7 



I t it n l i; i) n iiU 9 4 rf l ri >i H H i t. fa lt ' g l tt tf H i 



where 

Code = X'07 1 specifies a slave-mode request. 
= X'08' specifies a master-mode request. 



When a secondary task requests master mode (X'08 1 ), it is 
placed in master-mode/protected. 



SECLOAD This function call is available to primary 

tasks and background tasks loaded with the SMM option. 
The call is of the form 

CAL1,8 address 

where address points to word of the FPT shown below. 

word 





vmit 


1 


} 


0- 




T 


Segment number 




U 


6 i j Jt< i ! ) 
optional (PI) 


Pi * 10 11 


»? 13 H 15' 


It '- li nix 2' 22 htit is it 17l2l 2* Jo 31 


I 


o 





End-action interrupt/Label 


b i i ]U i « > 1 • * ic 1 1 

optional (P2) 







Address to process error returns 


6 1 


J J 14 5 t » 


• 


v 


10 M 


12 I] w 


>i 


It 17 * I4I2C 21 21 2JI2t 21 2t 27IX 2» » 3^ 



where 



Word 



X'OT specifies the SEG LOAD function. 



For STATUS calls only, if P14 is set, the account and user 
names for the current JOB will be stored in the five word 
data block. This parameter is not used by the MODIFY call. 



indicates the presence or absence of word 1; 
means absent, 1 means present. (P j is processed 
onlyifT=0.) 



MASTER, SLAVE These function calls (available only 

to the foreground) ere of the form 



CAL1, 5 address 



where address points to word of the FPT shown below. 



P_ indicates the presence or absence of the error 
address word. 



T indicates whether control is to be returned fol- 
lowing the call or transferred to the starting lo- 
cation of the segment at the conclusion of the 
segment load (0 = return to celling program; 
1 = transfer to new segment. ) 
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Word Options 

I indicates the contents of the end-action interrupt 
field (primary tasks only). 

I = indicates no end-action. 

I = 1 indicates an interrupt address. 

1 = 2 indicates an interrupt label. 



If end-action is specified, the request to load the 
segment will be queued and control will be re- 
turned immediately to the calling program. The 
calling program can then exit and release control 
while the segment is being loaded. If end-action 
is not specified (I = 0), control will not be re- 
turned unti I the segment is loaded. The user is 
responsible for checking the status of the load if 
end-action is selected. 



Address to process error returns is the address of 
the user's routine for processing an/ error or ab- 
normal returns received while attempting to load 
the overlay segment. The codes returned will be 
identical to those of the Type II READ CAL since 
a READ CAL is used by SEGLOAD to load the seg- 
ment. If this address is not present and an error 
occurs, o foreground program will be exited or a 
background program aborted. If an error is de- 
tected in the user's PCB or OVLOAD table, the 
User or System Trap Handler will be entered. 



Warning; Do not issue SEGLOAD calls from tasks of higher 
priority than the I/O interrupt. 



WAIT A background program will enter the "wait" state 

through this function call if an (ATTEND card was included 
in the control commands for the job. Normally, a back- 
ground program would use WAIT after typing an alarm to 
the operator that requires an operator response. While in 
this state, the Control Task waits for a key-in from the op- 
erator specifying the disposition of the background program. 
The operator may specify continue (C), continue from OC 
(COC), or abort (X). 



This function call is of the form 
CAL1,9 9 

NoFPTisused. 



TIME Programs may interrogate the monitor to deter- 

mine the time of day and date. 



This function call is of the form 

CAL!, 8 address 
where address points to word of the FPT shown below, 
word 



X'10' 



Address 



where 
X'10' 



1 



is the code for the TIME call. 



indicates the format of the returned values. 



Address is the address of the first word of the block 

to receive the time and date. If F] = 0, o four 
word block is returned; if F] = 1, a two word block 
is returned. 

For F] = 0, the block contains EBCDIC characters as shown 
below: 

word 



h 


h 


: 


m 


word 1 


m 


« 


m 


o 


word 2 


n 


* 


d 


d 


word 3 


/ 


1 


y 


y 



where 

hh 

mm 

mon 

dd 

yy 



is the hour (0 < hh < 23). 
is the minute (0 £ mm < 59). 
is the month (3-lerter abbreviation), 
is the day (01<dd<31). 
is the year (00 < yy £ 99). 



For F] = 1, the block contains packed binary values as 
shown below; 

byteO byte! byte2 byte3 

WordO 
Word 1 

where the values ore equivalent to those stated above 
except for: 

whole year is the foil date, 
mo is the number of the month. 
ss is the seconds (0 < ss < 59)o). 



whole year (i.e.,^976) 


mo 


dd 


hh 


mm 


ss 
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GETTIME This function call k used to return elapsed 

time to the calling task. It has the form 

CAL1,7 address 

where address points tr word of the FPT shown below. 



optional (P10) 



word 






X'6V 


r 

i 


n n 


u u 


Tm iii i < i 


1 


4 li 111 12 13 U uIm 17 11 !♦!» 21 22 23 1 24 23 » 17 1 It P X 31 



word 1 



Time 



6 I J lU S t 7 I 4 V U "hi 1! » lilx II II l*ljo 2i 22 2JU' 2i 16 2?!» 2» 

where 

WordO 



X'61 ' is the code for the GETTIME call . 

F, is the Timer option (1 is for time since mid- 

night; is for time since system initialization). 



Word 1 

Time is the current value of the timer. For F]=l, this 
is a binary number representing the number of seconds 
since midnight (this is the time set by the operator). 
For Fi=0, this is a binary number representing the 
number ofelapsed seconds since system initialization. 



STIMER (Request a Clock Interval Posting Service) 

This function call allows a task to sense when a specified 
time has been reached, either by subsequently checking 
the service or by waiting. The call is of the form 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'44' 



iU s * >li *"T6 nli2 il u isli» 17 ii i»l» Ji ffl ol»« is » »l» i 



word 1 



p l 




p 


p 


00 


p 

13 





r 

8 


F 




F 

1 





F 
3 


0—0 


f 

7 


U U 


'" 


6 


1 2 1 ! 4 1 « i 


t 




10 11 


12 


u w til w ir i4 nix it H 


h 


24 


21 


2e 


a 


ilJtX 


Jl 



optional (PI) 



Error address 



ZJ 



i i i lU i t J I. i >o nl 12 13 u'isli. 17 .1 itljo 21 12 iil» 25 it VlM H tt J>' 

optional (P9) 



End-action oddress 



1 1 * 2 3 I - 5 . 7 It * 10 llhill M liU t7 » HU 2. t) fa l i. fa t, t>lH H >i 3 



Type 



8 *?*?l4 s > n tll t it ntVi 13 " I 7" l 5l i. I f'iT itHoT T B K l k ii k HH » x i 



optional (P13) 



Time 



i \ i il< i . Ml I w nl 12 1J >♦ >sU 17 i. i*l» >< i! lilj* Js 2. 4rl2* 7< * 

where 

Word 

X'44' is the code identifying the STIMER function. 

P- is the presence indicator for word 1, (1 indi- 
cates presence). If Pq = 0, STIMER functions as 
though the time parameter was absent. 



Word 1 

P. is the presence indicator for the error address 
parameter (1 indicates present). 

P. is the presence indicator for end-action param- 
eter (1 indicates present). 

is the presence indicator for the type comple- 
tion code parameter (1 indicates present). 



r I0 



P.n is the presence indicator for the time param- 
eter (0 indicates absent and no timeout will be 
done; 1 indicates present and the CAL will be 
timed out). 

F- is a delete on post indicator (1 means delete 
the event when it is posted -no CHECK will 
be performed and the user's FPT will not be 
posted; means a CHECK will be performed). 
F R has meaning only when F, = 0. 

F.=l is a long-wait indicator, making a second- 

ary task a prime candidate for rot lout. 

F.=l specifies that the time word contains a thres- 
hold setting versus an interval value. 

F_=1 wait for time elapse before returning, versus 
returning to the next instruction as soon as the 
service request has been established. 

.*» 

F=l is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 
if errors are detected and no error address pa- 
rameter has been provided. 

Word Options 

Error address is the return for immediate errors. 
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I,end-action address I indicates the contents of the 
end-action address number field. (End-action is 
allowed only for foreground. ) 

1 = indicates an end-action BAL address to 
use when the time has elapsed. 

= 1 indicates an Interrupt address to be trig- 
gered when the time has elapsed. 

= 2 indicates an interrupt operational label to 
be triggered when the time has elapsed. 



Type completion, BUSY indicates the status of a 
timer service. 



optional (P3) 



Buffer address 



( i 1 1 1< J • Ml » 16 nlu ij U liU \i it Kltt Ji U Hlii is it »l» » jj 



optional (P4) 



Byte count 



\ J iW j t >U ♦ k n!ll li u'vjU tf It Hlkl. UUIm ai. b\n »" 



optional (P6) 






* 


o 


n 


BTD 




Tr 




> n in 12 is u Hi it 17 it »IH ji 12 2JI34 is It iMi 


» K )' 



BUSY = 1 indicates timer has been initiated. 

= indicates timer is completed and 
checked. 

Type completion = 1 indicates that the timer 
has elapsed. 

Time if F. = specifies a time interval in seconds. 

F, = 1 specifies the threshold time (since sys- 
tem initialization)when posting should occur. 



optional (P10) 



Completion 
code 


n 




1 2 3 U 3 » 7 


1 » 10 lllu IJ 14 lslu 17 II !tl» 21 22 a\lt 25 26 Z7 1 28 Kill 



where 

WordO 



Code is X' 66' and bit 8 must beset. 



If the Time parameter is omitted control returns to the 
caller immediately. The user may obtain the current 
time in seconds via the GETTIME call (specifying time 
since system initialization) to establish a base time for 
time threshold setting. 



ERRSEND (generate an error log message) 

A text message can be placed in the error log through use of 
the ERRSEND function call. The ERRSEND CAL has the form 

CAL1,7 address 

where address is the location of word of an FPT. The 
FPT has the form: 



Word I 





word 




















• 


Code 


1 




" 






. 




1 l 1 1 U 5 t 7 

word! 


_ 
i ♦ 10 ill 12 1] 14 131 It 17 » KI70 21 2} ijlii 23 It 27121 MC )1 


1 


'i 





'j 


\ 





'<, 











"n 


n n F r 








5 1)3 

optiona 


4 i t > 
1 (PI) 


1 f 10 II 112 13 M 131 M 17 II ItlJO 21 22 23124 23 It VIM It 3D 31 







Error address 




T" 


i 


5 


3 


14 


i 


* 


7 


li 


* 


tt 11112 13 M 


ultt 17 II t»l» 21 22 blj4 23 it t>\» 2* 30 31 



r 10 



is the error address parameter presence indicator 
(0 means absent; 1 means present). 

is the buffer address parameter presence indica- 
tor (0 means absent; 1 means present). 

is the byte count parameter presence indicator 
(0 means absent; 1 means present). 

is the byte displacement parameter presence in- 
dicator (0 means absent; 1 means present). 

is the completion type parameter presence in- 
dicator (1 means present; 9 means absent). 

is an abort override indicator: 1 means do not 
abort if errors are detected but no error address is 
provided; means abort if errors are detected and 
no error address is provided. 



Word Options 

Error address is the address of the entry to the user 
routine that will handle error conditions. 

Buffer address is the word address of the user buffer 
to be used in the VO operation. Data is written 
from this buffer. 
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Byte count it the size in bytes of the data record 
(55 byres maximum). 

BTD is the byte displacement (0-3) from the word 
boundary of the beginning of the data record. 
If this parameter is omitted and the buffer address 
parameter is included in the FPT, value is as- 
sumed for BTD. 

Completion status is the word wherein the system 
posts the completion parameters for the request. 



ALARM (initiates a system alarm shutdown) 

The ALARM call causes the system to perform an orderly 
shutdown. It has the form 

CAM, 7 address 

where address points to the FPT shown below. 



optional (PO in word 0) 



X'6A' 



Address 



'» I 1 lU S i Ml I II III!! IJ U IStl* ff II »!» 51 B Bl« IS U »!» * B )' 

where address points to a TEXTC message which will be 
logged on the operator's console as the alarm message. 



REC ALARM (set post-shutdown routine entry) 

The ALARM Receiver call specifies a post-shutdown action. 
It has the form 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'69' 

rrrrtTTT7 



l'U llll! I) u 



Address 

lilu. IJ II WlH }l H Hi J* liltSlXllli 



1 }U t I >l | f W lltl S H W B l U l> II W \ K II II B l H K M B l ] 



optional (PI) 



m » ir 



Error address 



s i 3 i U i t 7 It i n iilu ii m itli* i? w tiljs ji ji alw js » 2tIm n x r 



where 



WordO 

X'69' is the code for the RECALARM call. 

REB = 1 will cause the system to automatically 

reboot after alarm processing is completed. In 
this case, address is ignored. 

Address b the address to which control will be 
transferred when an alarm occurs. This transfer 
occurs after CP-R alarm processing is completed. 
A zero address will cause reset of the alarm ad- 
dress. Note that only one alarm address is active 
per system and the alarm address must reside in a 
foreground private memory area. 

P. is the parameter presence indicator (0 means 
absent; 1 means present). 



Word Options 

P. is the error address parameter presence indicator 
(0 means absent; 1 means present). 

Error address is the location to return to if errors 
are detected in the request. 



106 System Function Call Formats 



6. CP-R MEMORY MANAGEMENT 



REAL MEMORY ALLOCATION 

Real memory for CP-R is allocated at SYSGEN into a 
number of partitions that fall into four distinct classes as 
follows: 



e Space required for system patch area. 

• Space required for CP-R temporary space pool . 

• Spoce required for CP-R overlay area. 



CP-R System Memory 
Foreground Private Memory 
Foreground Preferred Memory 
Secondary Task Memory 



The layout of CP-R system memory is shown graphically in 
Figure 9. 

CP-R system memory is given a write lock of 11. Primary 
and secondary tasks execute with a write key of 01 and 10, 
respectively, and thus are prevented from modifying CP-R 
system memory. 



Each class of memory consists of one or more partitions 
whose boundaries and extent are established during the 
SYSGEN process. 



Memory partitions within a given class have certain com- 
mon attributes: 



1. They must begin and end on a page boundary. 

2. Within themselves they occupy contiguous real pages. 

3. They cannot be larger than 64 pages (32K). 

4. They may not overlap another partition. 



FOREGROUND PRIVATE MEMORY 

This CP-R class of memory is used exclusively by foreground 
primary tasks. Foreground blocking buffers used by pri- 
mary tasks may exist as a separate partition of foreground 
private memory or they may exist as an area within the first 
defined foreground private memory partition. 

If foreground blocking buffers are specified as a separate 
partition then the restrictions governing partitions are in 
effect. If they are defined as an area then these restric- 
tions are not in effect. 



Note that the Secondary Task Memory Partition consists of 
all of the real memory that is not explicitly allocated to 
another partition and therefore the 64-page restriction does 
not apply to this class of memory. 



An example of real memory allocation for a 64K system is 
shown in Figure 8. 



CP-R SYSTEM MEMORY 

CP-R system memory is comprised of one partition starting 
at memory location 16 (X'10 1 ) occupying a variable num- 
ber of real memory pages sufficient to contain the follow- 
ing items: 

• Space required for trap and interrupt locations. 

• Space required for resident CP-R system pointers. 

e Space required for resident CP-R system tables. 

e Spoce required for resident CP-R routines including 
resident overlays. 



The foreground mailbox is a special area within the fore- 
ground private memory class. The foreground mailbox may 
exist as a separate partition of foreground private memory 
or it may exist as an area within the first defined foreground 
private memory partition. 

If the mailbox is a separate partition, it is subject to the 
restrictions placed on memory class partitions. If it is an 
area within the first partition of foreground private mem- 
ory, then these restrictions are not in effect. 

Foreground private memory is given a write lock of 01. 



FOREGROUND PREFERRED MEMORY 

This class of memory may be allocated to-either primary or 
secondary tasks. Primary tasks may ocquire memory pages 
in this memory class only through explicit calls to CP-R 
memory management routines giving the real memory ad- 
dress of the requested page(s) 

Secondary tasks may acquire memory pages in this memory 
class by requesting virtual to real address correspondence 
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8 16 


24 


32 


40 


48 


64K 


CP-R 
System 


Foreground 
Private 


Secondary 

Task 


L. 


Secondary 
Task 




Secondary 
Task 


Memory 


Memory 


Memory 




Memory 


f" 8 


Memory 















1. Secondary Task Memory is used for Foreground or Background Secondary Tasks. 

2. CP-R System Memory for use by CP-R only. 

3. Foreground Private Memory used by Foreground Primary Tasks only. 

4. Foreground Preferred Memory may be used by either Foreground Primary Tasks or Foreground Secondary 
Tosks. 



Figure 8. Example of Memory Organization for 64K System 
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Figure 9. CP-R System Memory 
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for a particular Moment via the FIX option on the :SEG or 
rPUBLIB commands when the task is linked with IOLOAD. 
In this case the real page that has address correspondence 
to the requested virtual page must be defined as foreground 
preferred memory. 



Foreground preferred memory is given a write lock of 00 
making it accessible from both foreground primary and 
secondary tasks. 



VRTUAL MEMORY AUOCATON 

Each secondary task in CP-R has 128K of contiguous virtual 
memory available, regardless of the size of the real memory 
or of other users in the system. Some of this memory is 
available directly to the task and some is used for services 
that the task requests. Figure 10 shows the fundamental 
allocation of virtual memory. 



SECONDARY TASK MEMORY 



All real memory not explicitly defined as belonging to 

another memory class is called secondary task memory. All 
_-_„.. _.._t— iL.. not- :. -.-.-—J i_.i. _„.. __j 



fici memuiy cia» is cui icu secunuaiy rg»K memaiy. nil 

iory greater than 128K is secondary task memory and 
e may be pages of memory in the first 128K that fall 
this class 



there 
into 



This memory is used exclusively for secondary tasks and 
Public Libraries that are not used by primary tasks. 



SYSTEM VIRTUAL MEMORY 

System Virtual Memory (SVM) occupies virtual page 
through virtual page 47 and is divided into two separate 
areas, the first of which (CP-R) is common to all tasks, 
and the remaining area (CP-R overlays) is task dependent. 
SVM is given an access protection code of Read and 
Execute to prevent accidental destruction of critical sys- 
tem data. 



Virtual pages through 47 are reserved for resident CP-R 
routines. This area is mapped one-for-one with real memory; 
that is, there is address correspondence between real and 
virtual addresses. 



PRIMARY TASK MEMORY ALLOCATION 

Primary tasks are allocated contiguous real memory at 
!RUN or UNIT time from information contained in the 
task load module. If Public Libraries are to be loaded 
with the task, the memory that they require must be 
available at !RUN or UNIT time or the task load can- 
not be completed. 



More than one primary task load module may be loaded 
into a given foreground private partition, by issuing multi- 
ple RUN or INIT calls, providing that memory residency 
(as defined in the load module) conflicts do not occur. 



Primary tasks may acquire and release memory pages in 
foreground-preferred partitions by using the GETPAGE and 
RELPAGE function colls. The requested memory must be 
available at the time of the call or the request is not com- 
pleted. The memory acquired in this fashion does not be- 
long to any named segment as such and, therefore, cannot 
be shored with any secondary task. It is considered private 
to the requesting primary task. 



One page of SVM is reserved for CP-R overlays. These 
overlays are part of secondary task context and are used by 
CP-R in providing certain system services to the user. 



Note that the end of CP-R system memory does not neces- 
sarily end at the start of task virtual memory. Typically 
there is space left over in system virtual memory (which is 
always mapped one for one with real) that the user may 
define partitions in at his discretion. This allows user 
code to exist in both real and virtual memory if desired. 



TASK VIRTUAL MEMORY 

Task Virtual Memory (TVM) starts at page 4B (24K) and 
ends at page 239 (120K) providing 192 pages (96K) of 
virtual memory directly available to each secondary task. 
TVM is allocated, under user control, on a segment basis, 
where a segment consists of one or more pages. Control is 
exercised via a set of memory management operations which 
provide for activation, deactivation, overlay, and erasure 
of segments. 



The user must "remember" the pages he has acquired so that 
he may release them when they are no longer needed. 



The memory occupied by all tasks in a load module is re- 
leased when any task in the load module terminates. 



RESERVED PASES 

Sixteen pages (page 240 through 255) are reserved for system 
use on behalf of the user. These pages are used for such 
items as I/O blocking/deblocking buffers, Loader tables, 
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Figure 10. Virtual Memory Organization 



debug tables, symbol tables and other system information as 
needed. The first 1? of tl.ese pagas (240-25 1 ) ore job-level 
pages and ore shared by all tasks in that job. The remain- 
ing four pages are private to each task. 

ACCESS PROTECTION 

System virtual memory and overlay area is always marked 
read and execute. Task virtual memory access protection 
is controlled by the user on a segment basis. The reserved 
pages access protection is controlled by the system con- 
sistent with the type of data involved. 

Initially, all pages in TVM thot are undefined or not acti- 
vated are marked no-access, an attempt to reference these 
pages results in trap conditions being returned to the user. 

The user con control the access codes in TVM between 24K 
and 120K but cannot change access to SVM or the reserved 
pages. On dispatching every task, the access codes for all 
TVM is initialized to assure that all memory is properly 
protected. 



SOFTWARE SEGMENTATION 

The method of controlling the location of data or instruc- 
tions in virtual memory is by means of a software segmen- 
tation scheme as follows: 

1 . The active memory at any time is composed of a series 
of segments under software control . 



Each segment consists of an integral number of pages, 
from one to a maximum of 32 (the 32-page limit does 
not apply to the root segment). These pages within 
a segment are contiguous but there may be gaps in 
virtual memory between segments. 



3. Each segment is built by the Overlay Loader from one 
or more relocatable object modules (ROMs) or library 
routines. 



Eoch segment is given a number ond a virtual memory 
starting locationas well as lengthot linkage edit time. 
This number, virtual locotion, and length remain with 
the segment permanently. 



5. Each segment must begin on a page boundary. Segments 
may contain data, instructions or reserved space.or a 
combination. 



The segment is the smallest shorable unit of memory. Sev- 
eral segments may begin at the tome virtual memory address 
if desired, and if so, result in their being overlay segments 
for each other. Only one of these may be active at any 
one time, and the active one is represented in the actual 
hordware map at execution time. Because each segment 
is independent of other segments, any sort of overlay struc- 
ture may be built; the user is not limited to a conventional 
tree structure. 
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SEGMENT ACTIVITY 

The segments of a task may be in one of two states relative 
to that task: 

ACTIVE The segment is in real memory and in the map 
if the task is active. 

INACTIVE The segment is currently not available to the 
using task. If the task is active, the segment 
is not on the map. 

The above states reflect segment activity relative too given 
task. They do not, however, reflect the actual state of a 
segment from a memory management standpoint. This comes 
about because of sharabiliry, initialization, and roll-in/ 
roll-out considerations. 

For purposes of memory management, a segment has five 
distinct states: 

ERASED Segment contents do not exist in real memory 
but may be found in the tasks' Load Module 
(LM). This is the initial state of a segment 



before any segment activation has occurred. 
This state may also be reached if all tasks using 
a segment have ERASED it. . 

DEFINED This is a substote of ERASED. This state rep- 
resents an empty segment, one whose contents 
do not exist in the Load Module. 

ACTIVE One or more tasks have ACTIVATEd the seg- 
ment. The segment contents exist in real mem- 
ory and in the map of any active using task in 
which the segment is active ■ 

INACTIVE The segment contents exist in real memory; the 
segment is not active to any using tasks; and all 
using tasks have not erased the segment. 



ROLLED- 
OUT 



The segment contents exist in the roll-out file. 



Table 15 shows the transition operators and their effect on 
a segment relative to a task. Figure 1 1 shows the possible 
state transitions of a segment. 



Table 15. Segment States Relative to a Task 



~-~-— ^____^ Segment State 
Operation 


Segment Inactive 


Segment Active 


ACTIVATE 


Activates requested segment from Load 
Module if segment state is ERASED, 
from memory if segment state is IN- 
ACTIVE, from roll-out file if segment 
state is ROLLED OUT. ERROR if over- 
lapping segments in virtual memory. 
If ACTIVATE is to DEFINED segment, 
real memory for the entire segment is 
acquired. 


ERROR 


DEACTIVATE 


ERROR 


Causes segment to be made inactive 
to this task. Actual segment state may 
or may not change depending on shor- 
ability. CAL or FPT may not be in 
segment that is being deactivated. 


ERASE 


Segment contents may be lost (real memory released) depending on sharability. 
Segment remains inactive to calling task but segment state may change to 
ERASED or DEFINED. 


GETPAGE 


ERROR if segment state is not DEFINED. 
If page request to DEFINED segment 
acquires real pages and makes the seg- 
ment ACTIVE to the calling task. 


Acquires real memory. 


RELPAGE 


ERROR 


Releases real pages. If all real pages 
in the segment are released the segment 
is marked inactive to the task and the 
segment state is either ERASED or 
DEFINED based on initial segment state 
when loaded. 
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Figure 1 1. Segment States 



SHARING SEGMENTS 

The user may specify to the Overlay Loader that certain 
segments are to be shared between using tasks. A segment 
is system level if it is shared by two or more tasks within 
different jobs. A segment is job level if it is shared by two 
or more tasks in a job. A segment is task level if used ex- 
clusively by a single task. Segments are given numbers 
(by the user) that are used as parameters on CP-R service 
requests to manage the segment. Numbers need not be 
unique between jobs if a segment is defined by the user as 
job Level. System level segments numbers must be unique. 
Public Libraries are system level segments that are mort- 
gaged by CP-R on behalf of the user. 
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Segments that are job level may only be used by tasks within 
a given job. System level segments may be used by any task 
in the system. An example of system level sharing are 
Public Library segments. 

If all tasks sharing a segment terminate or eraselit, it is 
erased. Therefore, the user must never allow all using 
tasks to erase a segment if the contents are to be perma- 
nently maintained. In this case, it is rolled-out (if real 
memory is needed) when it is not active to any task, and 
is rolled in if it becomes active again. 

A system level segment is also erased if all using tasks within 
the using jobs terminate, or erase it. 



SKMEMT ACCESS PMTEC1WN 

Access protection for each segment is specified by the user 
through controls provided by the Overlay Loader. Seg- 
ments may be given any one of the following tyoes of 
protection. 

• No Access 

• fieod Only 

• Read and Execute 

• Write, Read, or Execute 

The given protection type applies to all pages in that seg- 
ment on a permanent basis, that is, CP-R does not pro- 
vide services to dynamically change the segments access 
protection. 

SECONDARY TASK STRUCTURES 

A mapped secondary task in CP-R is synonymous with a file 
which contains a header and a load module consisting of 
one or more segments. Load modules, when read into core 
memory and executed, become secondary tasks. The load 
module is written by the Overlay Loader (OLOAD) which 
inputs control cards, ROMs, PUBLIB linkage controls, etc.; 
performs all address resolution; develops absolute core 
images; and writes them on disk. It also writes the load 



module header which contains all control data required at 
I NIT time to load and execute the task. 



In order to understand the input options to OLOAD, the 
user must understand Memory Management in CP-R. 

The availability of a memory map on Sigma 9 and use of 
virtual memory allows more flexibility in structuring over- 
laid programs. 

Figure 12 illustrates a program with a conventional tree 
structure and an alternate structure, non-overlaid in virtual 
memory. The latter structure, if loaded in real memory, 
preempts large areas of real space which may be required 
by other tasks when activated. Such a structure for real 
memory programs is therefore not desirable. 

Use of the linear tree structure is ideal .for reentrant pro- 
grams in virtual memory. Those segments that contain re- 
entrant code may exist in core only once, and may be 
shored by multiple tasks that are simultaneously active. 
The ACTIVATE and DEACTIVATE calls affect only the 
status of a segment with respect to the calling task. There- 
fore, each task has a unique list of segments that must be 
core resident and CP-R assures that it is only given execu- 
tion control when all its active segments are in real memory. 
The total real memory required for the combination of tasks 
at any instant may be greater than available. In this case. 



Root 



I - 1 — I — I — I 1 — I 1 — I 1 — I — I — I 1 — I — I — I 
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a. Conventional Tree Structure 
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b. Linear Tree Structure 
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Figure 12. Tree Structure Options 
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the lowest priority task is made inactive and its segment* 
are rolled out to free real memory pages. These pages are 
then available to satisfy the higher priority tasks' require- 
ments. When enough core is available for the rolled-out 
segments to be returned, the inactive tasks are dispatched 
and allowed to complete. 



UNKING A PROGRAM IR REAL 
VERSUS VIRTUAL MEMORY 

The utilization of memory addresses by a program is largely 
identical in real and virtual memory with the characteristics 
shown in Table 16. 



r 



Table 16. Real and Virtual Memory Program Linkage 



Real 


Virtual 


Range is to last real memory address. 


Range isO-128K. 


Access beyond 128K requires real extended addressing. 


Simultaneous access of over 128K words is not possible. 


CP-R monitor and services use some portion of real 
memory which is only available to the user as "read" 
or "read and execute". 


CP-R monitor ond services use some portion of virtual 
memory which is only available to the user as 'read' or 
'read and execute'. 


Real Public Libraries load into fixed real addresses as 
established when PUBLIB is OLOADed. User must not 
use this real space for any other purpose if he ever 
executes with the PUBLIB loaded, even if he doesn't 
call it. 


Virtual Public Libraries load into fixed virtual addresses 
as established when the PUBLIB is OLOADed. User must 
not use this virtual space for any other purpose if he uses 
the PUBLIB. If he doesn't use the PUBLIB, he may use 
the virtual space. 


Segments that are loaded into the same area in real 
memory cannot be simultaneously resident. The user 
is responsible for explicitly loading segments (by 
use of SEGLOAD) prior to using them and assuring 
that his logical flow and overlay structure are 
consistent. 


Segments that are loaded in the same area of virtual 
memory can not be simultaneously in the map. The user 
must continue to do explicit ACTIVATES and properly 
structure logical flow and physical layout. 


Segments that are loaded into unique real areas of real 
memory can be simultaneously resident and are always 
available for use once loaded via SEGLOAD. 


Segments that are loaded into unique areas of virtual 
memory can be simultaneously resident, i.e., will use 
unique real pages. Availability in real memory and pre- 
sence of the pages in the map are controlled via explicit 
system colls ACTIVATE, DEACTIVATE and ERASE. 


The memory required for a segment is always available 
since it is acquired at task initiation as a part of the 
contiguous space in the private partition. 


The core required for the segment must be acquired when 
the segment is activated, and is released when the segment 
is erased or rolled-out. 


Segments are reloaded from the load module on 
SEGLOAD. 


Segments are rolled-out and rolled-in from the disk as 
they are DEACTIVATED and ACTIVATED; therefore, con 
be modified during execution. They are reloaded from 
the load module on ACTIVATES after ERASES. "* 


User tasks linked such that they overlap in real memory 
cannot execute simultaneously. The user must carefully 
plan his real memory utilization within the private 
partition. 


User tasks linked to overlapping virtual addresses can be 
executed simultaneously on different tasks. That is, each 
task is completely independent of other tasks, except for 
PUBLIB or shared segments. 
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UNKING A HIOCMM USING SIMPLIFIED 
MEMORY MANAGEMENT 

Secondary tasks may not use the SEGLOAD service, and 
may not access memory addresses which are not in an active 
segment. However, the FORTRAN SEGLOAD subroutine 
uses the SEGLOAD service, as do many programs written 
for use under Xerox RBM, from which CP-R developed. RBM 
programs also could use memory beyond their active seg- 
ments. To support these as secondary tasks, a "Simplified 
Memory Management" (SMM) program structure has been 
provided. In this structure, the program, although secon- 
dary, is allowed to use the SEGLOAD function, and may 
access any address in a range determined when it is initiated; 
but it may not use any memory management services. 

For a background program, the accessible address range starts 
at the beginning of the program and continues for the num- 
ber of pages specified by the BMEM value. This value 
defaults to 32, but may be set both at SYSGEN and by 
operator key-in. Certain low-core locations ore set to 
point ot interesting locations in this range: K:BACKBG 
(X'140") points to the start of the range, K:6CKEND 
(X'141 1 ) points to the end of the range, ond K:BPEND points 
at the first word past the end of the program as linked. This 
means that K:BPEND and K:BCKEND define an area which 
may be used as scratch storage. 

For a foreground program, the range starts at X'6000" and 
extends for a number of pages defined in byte zero of eel I 
K:FSMM (X'217'). This value may be set only by re- 
assembling the SYSGEN processor. 

A program with SMM structure is treated by memory man- 
agement as only two segments, which are always active. 
(The user, however, deals with the segment structure de- 
fined when the program was linked. ) One of these segments 
covers the entire program as it was linked. The other covers 
the virtual addresses between the end of the program and 
the end of the accessible range described above. Since 
these segments are always active, the program will be rolled 
out whenever there is not enough secondary task memory 
for its entire accessible address range available at its 
priority. 



The function calls are as follows. 

ACTIVATE This function call activates the specified 

segment. The call has the format: 

CAL1,7 address 

where address points to word of the FPT shown below: 

word 



X'52' 



Segment number 



o i i 7T*™T™t"™rTfce~™n~nTT™iTT4"Tiri<rT^ wl*- .t :.• ?i!.'j .-j 



optional (PO in word 0) 



i 2 J I* - e r I t -> 10 ,ll >? Ij 14 ij le I." IE ffl JC ?l ?: H 



?: y i . ^ i it, :: : ?t .« 



optional (PI) 








i 2 1 1 ' i o "It" 16 I 


ol 

! ij ij u :_lfc ■■- 


Error address 



optional (P10) 




Completion 
Code 


n n 


<J 

t -' i\ lilt; ll Ij ll. 1' „ ulM .'. ■.' i'K ; '. ■■'■ ;. ' 



where 

WordO 



X'52' is the code for the ACTIVATE call 



?n is the parameters presence indicator (0 means 



absent; 1 means present). 



Segment number identification of the user's segment. 



MEMORY MANAGEMENT SYSTEM CALLS 

Memory management system calls may be made only when 
a user has been given control as follows: 

1. The background or foreground leader has transferred 
control to the user's start address. 



2. The user's centrally connected primary task has been 
given control upon the occurrence of the associated 
interrupt. 



Word Options 

P is the error address parameter presence indicator 

(0 means absent; I means present). 



P.- is the completion code parameter presence in- 
dicator (0 means absent; 1 nitons present). 



F_ is the abort override indicator. If set, control 

will be returned to calling instruction + 1 if errors 
are detected and no error address parameter has 
been provided. 
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Error address is the location to return to if errors 
are detected. 

Completion code will be posted by the system 
indicating the outcome of the service. 



DEACTIVATE This function call deactivates the speci- 

fied segment. It has the format: 

CAL1,7 address 

where address points to word of the FPT shown below. 

word 



X'53' 



Segment number 



4 i i ) I* 9 t Ml t w 11I12 u m is' it i> ii i»ljb li b 23 1 2* u it 2?!?e r> x 



optional (P0 in word 0) 



i 




P 
10 


n t\ 


t 

7 





U U 


1 


1 J 3 1 4 5 i J It 


» 


ii uli] 13 m ijl ii 1> ii ill it ii U H\it » it v\n v x 


31 



optional (PI) 



Error oddress 



~0 5 2 3 I 4 i 4 fTi 9 10 11112 13 14 15114 17 II 19 1 2C 21 23 23I24 25 36 27l» 39 30 3 

optional (P10) 



Completion 
Code 



K 31 33 illfc B li J7lH J» M 3l' 



B I ! 3 l i ! I J 1 1 ' It I I I 1 3 1 3 U I f I I t 1 ? U WHC 3 1 33 33 1 3* 

where 

WordO 

X'53' is the code for the DEACTIVATE coll. 

P n is the parameters presence indicator (0 means 
absent; 1 means present). 

Segment number identification of the user's segment. 
Word Options 

P. is the error oddress parameter presence indicator 
(0 means absent; 1 means present). 

P. n is the completion code parameter presence in- 
dicator (0 means absent; 1 means present). 

fy is the abort override indicator. If set, con- 
trol will be returned to calling instruction + I if 
errors are detected and no error address parameter 
has been provided. 

Error oddress is the location to return to if errors 
are detected. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 



ERASE This function call erases the specified segment. 

It has the format: 

CAL1.7 address 

where address points to word of the FPT shown below. 

word 



X'54' 



Segment number 



1 I I l \ * i i > l l ' » M ll l li H h U l U ' B II H I M i\ H B l fc ii it »Ht H 16 3 
optional (P0 in word 0) 



O'Jo 



I'l 1 Hi J . Jll't'tt 111 12 ii u ulu it- 11 tflttii ii fal» ait fclj. J» 16 ji' 
optional (PI) 



Error oddress 



! 3 ) U S i 7 li I » llllj 13 14 lit U 17 it 4 1 20 21 h 23 1 24 li 16 H\h k X 31 

optional (P10) 



Completion 
Code 



o \ i 1U i . >U ♦ \t Il l ii » u b l it \i it it l ttSi u a l t* tit. P ) M H to li 
where 

WordO 



X'54' is the code for the ERASE coll. 

Pq is the parameters presence indicator (0 means 
absent; 1 means present). 

Segment number identification of the user's segment. 

Word Options 

P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

P.- is the completion code parameter presence 
indicator (0 means absent; 1 means present). 

Fy is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error oddress parameter 
has been provided. 

Error oddress is the location to return to if errors 
are detected. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 



GETPAGE This function call gets pages of memory for 

the specified segment. If the segment is not active, it is 
activated. The call has the format: 

CAL1,7 oddress 

where address points to word of the FPT shown below. 
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wordO 



X'57' 1 



*l I ! il4 ! i 111"! 

word 1 



I lllB H U 111 



Segment number 



U 9 "■ Wt » I I g B f V H % gl B II B I 







100 



0', 



I 'I I lU ' l V tl l ' t Tt 1I I U II U U l l* W II BlB ii B Blfa H 11 BH Bffi 
optional (PI) 



H-TT 



Error oddress 



v i Hi i « >u i u tim ii u u i » w h m» Mi ti i i. fa I. g i n y « 

required (P6) 



n i ii. n mi i <i\\\A u uulu nnnttm T 
required (P7) 



VPN low 

1. git gt B »»i 



0— VPN high J 



optional (P10) 



Completion 

Code 
t i i jT* i » J 



3 



l t tt fiUi Ii W U l W W a Wlit > it IS l i* » It g l M B 16 » 



where 

WordO 



X'57' Is the code for the GETPAGE call. 

Segment number identification of the user's segment. 

Word 1 

P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

P |n is the completion code parameter presence in- 
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dicator (0 means absent; 1 means present). 



F 7 is the abort override indicator . If set, con- 
trol will be returned to calling instruction + 1 if 
errors are detected and no error address par a meter 
has been provided. 

Word Options 

Error address is the location to return to if errors 
are detected. 

VPN tow is the virtual page number of the lowest 
page requested. This is the high order 8 bits of 
the 17 bit virtual memory address of the page. 
VPN low is set equal to VPN high + 1 on comple- 
tion of the service. 

VPN high is the virtual page number of the highest 
page requested. This is the high order 8 bits of 
the 17 bit virtual memory address of the page. 



VPN high is set equal to VPN high + 1 on 
. .completion of the service. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 



■ELPACE This function call releases pages of memory 

from the specified segment. If all pages ore released, the 
segment is erased. The col I has the format: 

CAL1,7 oddress 

where oddress points to word of the FPT shown below: 

word 



X'58' 



• i i IN I i 1 
word 1 



Segment number 



I HH l BUUU l UWII B i g 11 g Bill ii V B I B Hit 3 



— 



00 



ii i lU ' ivm'i 'a ii i u u u u l u i > u iHmt gnu fatvam mt V 
optional (PI) 



Error address 



\ I Hi 1 I HI I Wll l tf III. U l lt P H B I B »i « B l i* Hit g l H H « 3 
required (P6) 



VPN lew 



i rnu n Hi i w u l u u u u l u w b b i b h b b 1 i»m v g l Hint i 
required (P7) 



I I I 1 1 



Ml I w m» \i mi l u 9 II W i g »i g fllli ii it B l B 9» V 



VPN high 



optional (P10) 



Completion 



I I 11. I l Ml I H U l il U U U l U P H BlB I I B B l i. H It B l B B K V 
where 

WordO 

X'58' is the code for the RELPAGE call. 

P Q is the parameters presence indicator (0 means 
absent; I means present). 

Segment number Identification ollhe user's segment. 
Word 1 



P. is the error oddress param e t e r presence indicator 
(0 means absent; 1 means present). 

P.q is the completion code parameter presence in- 
dicator (0 means absent; 1 means present). 
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fy is the abort override Indicator. ' tf tot, con- 
trol wll I be returned to calling Instruction ♦ 1 If 
errors are detected and no arror address parameter 
has been provided. 

Word Options 

Error address is the location to return to if errors 
ore detected. 

VPN low is the virtual page number, plus one, of 
the lowest poge to be released. This is the high 
order 8-bIts of the 17-bit virtual address of the 
poge. VPN low is set to VPN low, minus 1, on 
completion of the service. 

VPN high is the virtual page number, plus one, 
of the highest poge to be released. This is the 
high-order 8-bits of the 17-bit virtual address of 
the poge. VPN high is set to VPN low, minus 1, 
on completion of the service. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 



LOCK This function call locks all octive segments in 

the task in core memory inhibiting roll-out for the calling 
task. It has the format: 

CAM, 7 oddress 

where oddress points to word of the FPT shown below. 

word 



X'55' 



i i iiUinli ' t » hibu u u i »i> ti hhhi b am h % pi « mif 
optional (PO in word 0) 



I t 1 1 1 I I til ' l ' It H i ll H U U I U B U WHtl.BB l UUIt PHtBU ' W 



optional (PI) 



Error address 



t \ I ,U I I t\ i I It tl l n ii U ill* 1> it tf l it i- b rili. fa k BHHt it ii' 
optional (P10) 



Completion 
Cede 



i i i i l l m il i » n l n ii u »m v ■ mtv b bI ubb Pl an * if 
where 

WordO 

X'55' is the code for the LOCK call. 

P. is the parameters presence indicator (0 means 
absent; 1 means present). 



Word Options 

i 

P. is the arror oddress parameter presence indicator 
(0 means absent; I means present). 

P, n is the completion code parameter presence in- 



10 



dieator (0 means absent; 1 moans present). 



F_ is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1, if 
errors are detected and no arror oddress parameter 
has been provided. 

Error oddress is the location to return to if errors 
are detected. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 

UNLOCK This function call unlocks all segments in 

the task and mokes them candidates for rol I out. It has the 
format: 

CAL1,7 oddress 

where address points to word of the FPT shown below. 

word 



X'56' 



t i i il< i « j!i» <t ulii ii u ijlk n u i»im ji »a\ii a v»!j* jt u n 
optional (P0 in word 0) 



« I J Jl« s • JU J I 'it litu Ii U ill* i> u i+lii ii tib\»hk B\H » 16 ii 
optional (PI) 



Error oddress 



lll)l<i.)IIN .11 .i il UUU i> W WljtJi Yt UIJ. Is it B\k » jJ i. 
optional (P10) 



Completion 
Code 



» 



t \ l 11 4 i i >U i 16 li l d U U U t b tf H W l B H g B I S. H h 9 \ H » H )' 
where 

WordO 

X'56' is the code far the UNLOCK call. 

P. is the parameters presence indicator ffl means 
absent; 1 means present). ■* 

Word Options 

P. is the error address para m eter presence indicator 



(0 means absent; 1 means present). 



P.. is the completion code parameter presence in- 



10 



dieator (0 means absent; 1 means present). 
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F_ is the abort overr id e indicotor. K set, con- 
trol wtll bo returned to colling Instruction ♦ 1 if 
errors oro ootoctoo and no error octoroes parameter 
has boon provided. 

Ettot address is the location to return to if errors 
are detected. 

Completion code wi II be posted by the system in- 
dicating the outcome of the service. 



PREFMOOE This function coll, available only to fore- 

ground tasks, is used to control the avoi lability of fore- 
ground preferred partitions. When the function call is 
executed, all pages in the specified preferred partition 
that hove not been acquired by a task will be released 
(release mode) to the free page pool (STM memory) or ac- 
quired from the free page pool (recover mode). The call 
has the format: 



Word Options 

P. it the error address parameter presence indicator 
(0 means absent; 1 means present). 



10 



is the completion code parameter presence in- 
dicator (0 means absent; 1 means present). 



F_ is the abort override indicator. If set, con- 
trol will be returned to calling instruction + 1 if 
errors ore detected and no error address parameter 
has been provided. 

Error address is the location to return to if errors 
are detected. 

Completion code will be posted by the system in- 
dicating the outcome of the service. 



CAM, 7 address 
where oddress points to word of the FPT shown below: 
wordO 



X'50' 



Partition base oddress 



» i i lU 5 « > l» * io ill i: il u uli* i7 w i»lji Ji b h\U b fc VlM H It J 
optional (P0 in word 0) 



4'l i 1U i . )li . i« nli! ij w uL i> it *\H JiUlilJ. BfcUlH H 46" Ji 
optional (PI) 



Error oddress 



t I 2 I I 4 1 > 7 I • * H> III U 13 M is! U 17 It »lj0 2) 22 s!» 23 It sin * JO II 

optional (P10) 



Completion 
Code 



B I ! Hi S i rll I K llll! 1] u ulu n U WlR !1 B HlM B It JJlH 9 S 31 



where 



WordO 



X'50' 



is the code for the PREFMODE coll. 



P n is the parameters presence indicator (0 means 
absent; 1 means present). 

MODE is if operation is the recover STM pages 
and is 1 if operation is to release the partition 
to STM. 

Partition Base Address is the storting address of the 
preferred partition that the operation is to affect. 
If this field is zero the operation will take place 
on all preferred partitions. 



R0LL4UT/ROLUR 

i 

Roll-out and roll-in of mapped secondary tasks is performed 
automatically by CP-R as demand for memory resources 
varies. The roll-out process is controlled on a segment 
basis with selection of segments to be rolled-out based on 
segment state, number of tasks sharing the segment, and 
the priority of the using tasks. 

The selection algorithm it constructed such that there are 
nine distinct levels of roll-out. Within each roll-out level, 
selection of candidate segments is based strictly on the 
using task priority; that is, low priority segments will be 
selected before higher priority segments. 



The advancement of roll -out level 
factors: 



is controlled by two 



1. Roll-out will be stopped when a sufficient number of 
memory pages hove been acquired to satisfy the highest 
priority memory request. 

2. Roll-out will be stopped when the highest priority 
memory request would require that active segments of 
a task of equal or higher priority be rolled out (with 
the exception of tasks on long-wait). 



The roll-out levels ore presented in Table 17. When level 9 
is reached the message "MEM SATURATED" is output on the 
OC device and the system will wait for^a change in memory 
status. •* 

Roll-in of segments that were active when rolled out is per- 
formed in priority order. That is, highest priority seg- 
ments will be rol led in first. Roll-?n of segments that were 
inactive when rotled-out is done when an ACTIVATE call 
is issued for the segment. In this ease the rol l-in wi II be 
done at the priority of the requesting task. 
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Table 17. Roll-Out Levels 



Table 17. Roll-Out Levels (cont. ) 



Level 


Segment Selection 


1 
2 
3 

4 . 


Background inactive segments. 
Long-wait task's inactive segments. 
Long-wait task's active segments. 
Requesting task inactive segments. 



Level 


Segment Selection 


5 


Normal task's inactive segments. 


6 


Overlay pages. 


7 


Background active segments. 


8 


Normal task's active segments.. 


9 


Memory saturated. 
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7. ASYNCHRONOUS OPERATION CONTROL 



Asynchronous operations consist of independent events that 
eon take place concurrently with task execution. The 
available asynchronous services and their interface with 
an executing task are more ful ly defined in Appendixes H 
and I, "Job Management" and "Task Management". The 
monitor functions that may operate on these asynchronous 
services are described below. 



CHECK COMPLETION 

CHECK The CHECK function tests the type of comple- 

tion of an asynchronous operation Initiated by a no-wait 
request. The user specifies addresses, which are entries to 
his routines, that handle error and abnormal conditions. 
At entry, register 10 contains the error or abnormal code 
as detailed in Appendix N. Background users may take 
advantage of the standard system handling of the error and 
abnormal oddress in theFPT. The action taken by the sys- 
tem in this case is also detailed in Appendix N. Fore- 
ground users must provide both error and abnormal addresses 
when checking (CHECK, no-wait) requests. 

Users may specify a CHECK with no-wait by including a 
busy address in the FPT. This oddress is taken (with the 
address of the location following the CHECK CAL1 in 
register 8), if the CHE CKed operation is not complete. If 
no busy oddress is included in FPT, the CHECK function will 
wait for completion before taking the appropriate action. 

The CHECK function (through its own FPT)oddresses a DCB 
or an FPT, depending upon whether the request was Type ! 
or Type II. The FPT associated with a request is addressed 
if the request was Type II and the completion parameters 
were posted in the FPT by the I/O system. A DCB is ad- 
dressed if the request was Type I and the completion param- 
eters were posted in the DCB. 

For non-l/O operations, the CHECK request always ad- 
dresses an FPT. 



The CHECK function call is of the form 

CAL1, 1 address 
where address points to word of the FPT shown below. 




optional (PI) 



X'29' 



DCB or FPT address 



I 'l llUl t Ml t W h l ii \i m ' JU » H *HUigm» bt»» I M H in 



>0 



■or. 







rri'i i i i * mVd ii i a u u m» » u 4Ut i. u an. ' fa s> am mi 



Error address 



n i in limn wu u u ' mu b h nm h b h i s. u s, gi » h a i 
optional (P2) 



Abnormal address 



I I i Hi I I ti l I mi l d U U ' UU # II tf l it }. 8 M l fc b 1. » I M H 36 j 
optional (P3) 



Busy address 



i i i in i i *u i w m is u u'uu i> u w» ji a ui}« b it »m » u j 
where 

WordO 



X'29 1 is the code for the CHECK function. 

DCB or FPT address is the address of the DCB of 
FPT where the completion status is posted. Pjo 
determines whether this field contains o DCB or 
FPT address. 

Word 1 

Pj is the error address parameter presence indicator 
(1 means present; means absent). 

?2 is the abnormal address parameter presence in- 
dicator (1 means present; means absent). 

Pg is the busy address parameter presence indica- 
tor (1 means present; means absent). 

P|q is a bit indicating whether a DCB or FPT is ad- 
dressed (0 means DCB; 1 means FPT). 

F0 is the long wait indicator; makes secondary task 
a prime candidate for roll-out. 

F7= 1 specifies an abort override (return to next in- 
struction) if an error occurs. 



Word Options 

Error address is the address of the entry to the 
user's routine that will handleaerror conditions. 

Abnormal address is the address of the entry to 
the user's routine that will handle abnormal 
conditions. 

Busy oddress Is the address of the entry to the 
user's routine that will handle the "request busy" 
conditions. 
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KLFPT (Delete o Requested Service) <._--,-.,* 

This function forces premature completion and/or aborts 
the request to the greatest possible extent. This function 
is of the form 

CAL1,7 address 

where address points to word of the FPT shown below. 

wordO 



X'47' 



DCB or FPT address 



* ' l 1 Hi I I i l l I B H l b li U ' li l * » II M* i< fa p i * fa » l fc fc fa ; 

word 1 



I' l l ! I i > U 'I I B 111 1 3 I I u u l u w I I wl it » b gi n a h g l » > r n 
optional (PI) 



Error address 



II IIDU Hi t m H i ll 1 5 U ' H l U B H W l K H B B l »4 B H gla m ■ 1 

optionol (P2) 



Abnormal address 



n i in i i il l i ii mu u u ' u i u i> u hu ii h » i » a k giM m at 
optionol (P3) 



Busy address 
UlU V II HlJt II B Bll* U It 9(8 JIB 3 



I I I Hi i 1" ? U I U » I B Ii U 

where 

WordO 

X'47' is the code to call DELFPT. 



DCB/FPT address Is the location of the FPT (DCB 
In Type I I/O only) with which service was origi- 
nally requested. 



Word 1 



P. indicates the error address is present. 
P» indicates the abnormal address is present. 



P. ts the busy address parameter presence indicator 
(1 means present; means absent). 

P.q indicates either the FPT or DCB address in 
word (1 means FPT; means DCB). 



--.. indicates that if an optional error and abnormal 
address is reached but was not provided, return is 
to the next instruction versus abort. 



Word options 

Error address Is the address where all non-l/O 
errors exit, plus any I/O errors of the FPT error 
address class. 

Abnormal address is the return location for FPT 
abnormal address I/O errors. 

Busy address is the address to return to if the ser- 
vice being checked is not complete. 



If the FPT or DCB address provided does not have a service 
outstanding, the FPT or DCB is not altered in any way and 
the service normal, error, or abnormal exit is taken, based 
on the last completion in the FPT/DCB whose service is 
being deleted. 

If the service is still in process, it will be processed until 
a wait condition occurs. 

If P3 - 1, a busy address is provided and will be taken. 
The user must issue another CrffCK or DELFPT later. 

If P3 = and the service being checked is not one that can 
legal ly be waited for, the task is aborted. Otherwise, the 
task will wait for the service to be completed, at which 
time the exits described below will apply. 

If the completion was normal (completion code = 01), the 
status and any feedback data will be stored per the original 
FPT, and the next instruction exit will be taken. 

If the completion was in error (on I/O services, those con- 
ditions taking the FPT error exit; on all other services, any 
nonzero completion code), the status and feedback data 
will be stored per the original request FPT. R8 will be set 
to the DELFPT CAL+1. Byte of RIO will be set to the 
error code. Bytes 1-3 of RIO will be set to an address; to 
the DCB address if the request was for I/O; to the request 
FPT address if the request was another service. 

If an error address was provided on the DELFPT FPT, con- 
trol will be returned to it. 

If no error address was provided but F7 = 1, the normal exit 
will be taken. 

If no error address was provided and F7 = 0, the) callers task 
will be trapped to the BADCAL trap (X'50 1 ). 

If an abnormal I/O completion occurred, the logic is as 
above using the abnormal address parameter. That is, the 
original FPT is completed, R8 and RIO are set and the users 
abnormal address is given control . If the abnormal address 
is not present, return is to the instruction following the 
DELFPT call with R8,R10 unchanged. 
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Tasks must provide a busy address, en DELFPT of services 
Cm- which watt is Illegal. Requests without a buy address 
by a task will com* the caller to be trapped. 

Fields In the original request FPT wSich will be stored on 
completion are the completion code (optional) and data 
from the data area (optional). 



Service requests should be deleted only once after they 
are completed . If a busy address is provided and CP-R exi ts 
to it the service is still in process. Once a normal, error, 
or abnormal exit is taken, the service has been deleted. 



Services can only be deleted by the original requesting task 
or another task in the same load module. The quiescing 
of the service and removal from the system will vary as 
a function of the activities in process. Waits may occur 
in order to bring the request to a controlled termination. 
The busy address will be used if provided when a wait 
is encountered. 



Multiple, simultaneous deletes of a service by more than 
one task cannot be allowed. This has the following 
significance: 

e A CHECK or DELFPT on a service which was requested 
with wait will cause a busy return (if provided) or trap 
(no busy return is provided). 



A CHECK or DELFPT on a servicewhich is in CHECK, 
DELFPT, or TEST processing by another task will cause 
a busy return Of provided) or a trap (no busy return 
provided). 



These conditions can be avoided by proper coding of 
CHECKs and TEST calls, or by only allowing one of the 
tasks to do all checks and/or tests. 



optional (PO in word 0) 



r. K 



n ' i ' t s l i i « > u » n inn » ■* mu » ■ w i mm a 1 



optional (PI) 



S'JTBlH H V j. 1 



3 



t i i n« i « hi i h ma u u 



optional (P2) 



Error address 



' HUH U H l lM. gB l wis k tUhhk: 



Abnormal oddress 



'» I 1 Jl< i t III I it ill.l U uUit i> it illtt }i h fall, js t, H\n ii 'x, 2 

where 

WordO ' 

X'40' fs the code identifying the WAITALL function. 

PO is the word-1 parameter presence indicator 
(1 indicates present). 

Word options 

P. indicates the error oddress is present . 

P. indicates the abnormal oddress is present . 

F0 is a long-wait indicator, making a secondary 
task a prime candidate for roll-out. 

Error address is the address where all non-I/O errors 
exit, plus any I/O errors of the FPT error address 
class. 

Abnormal address is the return location tor FPT ab- 
normal oddress I/O errors. 



If a task does a service request without wait using an FPT 
in registers, the register content must be the same at check 
time as it was when the service was requested. 



■JUT ALL This function call allows a task to wait until 

all previously requested no-wait services have completed. 
It has the form 

CAL1,7 address 

where address points to word of the FPT shown below: 

WordO 



X'40' 



Vl J 1 1 4-1 



.'♦ rfit l u U wrf l U B U# \ i h HUH. fa it g t UKtt 3 



If any previously requested service is complete, a CHECK 
will be performed; that is, the completion code and data will 
be moved to the originally requested FPT. WAITALL will 
return only if it has checked and deleted all outstanding 
services. 



Tasks cannot use WAITALL if any previously requested service 
cannot legally be waited upon. WAITAjJL will wait for all 
services requested by any task In the caller's load module. 



If ony of the "checked "cervices completed in error, registers 
8 and 10 will be set as shown in Appendix N and the return 
will be to the Specified error or abnormal address in the 
WAITALL FPT. If any of the services completed in error and 
the error oddress is not present, the task will be aborted. 
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MiTANY This function call allow* a to* to watt for 

any previously requested service to complete. WMTANY 

MI FfW HMWUI 

CAL1,7 address 
whore address points to word of the FPT shown below. 



WordO 










X'41' 
'l t t 1U l i 


k 

-TTT 


— 

t H II 


•I 

il 11 U x 


FPT or DCB address 

In 17 w iris it a all. b j» via i» jo ji 



opt 


onal (PO in word 0) 








r 
i 


p 

2 
i 


** 


n 


'0 

it 


0! 

'fa v vlii » 11 i. 


1 lli i t 7I* » a nil} » u 11! u 


i* it *\k i> to h 



optional (PI) 



Error address 



i 1 ni« > i > i i * * b i n 13 uu i i. » a w i ioii a h i i. fa i> gin* » t. 
optional (P2) 



Abnormal address 



i 1 i i 1 . 3 i > u t ru t n j-u ' i^ r i; p u uu 1 b mt. ti h g i H ■ a !. ' 

where 

WordO 

X'4T is the code identifying the WAITANY 

function . 

P. is the word-1 parameter presence indicator. 

FPT or DCB oddress is the field where WAITANY 
returns the oddress of on original servi ce -request 
FPT or DCB (for type I I/O) which has been com- 
pleted and checked . If FPT or DCB oddress is 
cero on return from WAITANY call, no outstand- 
ing requests were found . 

Word options 

P. indicates the error oddress is present . 

P- Indicates the abnormal oddress is present. 

F. is the long-wait indicator, making a secondary 
task a prime candidate for roll -out. 

Error address is the address where all non-I/O 
errors exit, plus any I/O errors of the FPT error 
oaaress class. 

Abnormal oddress Is the return location for FPT ab- 
normal address I/O errors. 

If any service is complete, a CHECK will be performed; 
that Is, the completion code and data will be moved to 



the original request FPT. WAITANY will then return to'the 
caller. The address of the FPT that was checked is stored 
In the WAITANY FPT. ♦' 

If the "checked " service completed in error, registers 8 
and 10 will be set as shown in Appendix N and the return 
will be to the specified error or abnormal address in the 
WAITANY FPT. 

If no services ore complete, WAITANY will not return con- 
trol until at least one service has completed. WAITANY 
will return control immediately If no service requests ore 
outstanding. 

Tasks may not use WAITANY if all previously requested 
services cannot legally be waited upon. WAITANY will 
wait for any service requested by any task in the caller's 
load module. 

Services originally requested using FPTs in registers will 
give unpredictable results on WAITANY. 



TEST This function call allows a task to test if any pre- 
viously requested services have completed. TEST is like a 
WAITANY which never WAITS but always returns control to 
the user. This function call has the format 

CAL1,7 address 

where oddress points to word of the FPT shown below. 

WordO 



X'42' 

'» 1 l Jl« 1 i t 


t 


r ■ 1 


'l U llll! U VlU 9 I *l* 11 » Blii B 1> 0!U * » 31 



optional (PO in word 0) 



I'l '1 Jli I I tit • It II lii ij m ak I> U Witt ii B Bit. b It »!tt » Jo ; 

optional (PI) 



error address 



I Mil. 11 ) 1111 ti l t) B U ' U l W B U H l » }H BH. Hit Pl«*M 31 ' 
optional (P2) 



Abnormal address 



i t i il* i « tit 1 n u i uu u ' til k ,7 4 w i it ti h a i t. fa fa g i tnnti 



WordO 



X'42' is the code to call the TEST function. 

P. It the word-1 parameter presence indicator 
(I indicates present) . 
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FPT or DCB address b if* field where TEST returns 
the address of an original servi c e r eq u e st FPT or 
DCB (for Type 1 I/O) that hat boon eomplatod and 
checked . If FPT or DCB address Is zaro on ntturn 
from a TEST call, nona of the outstanding requests 
oni completed • 



If a sorvtca Is complete, a CHECK will bo perfor m ed; that 
b, the completion eode and data will be moved to the 
oriotnal request FPT and the address of the FPT that was 
checked is stored in the TEST FPT. If no service is com- 
plete, TEST will return control immediately and the FPT ad- 
dress field in word of TEST FPT will be zero. 



Word options 

P. indicates the error address is present. 

P 3 Indicates the abnormal address Is present . 

Error address is the address where all non-I/O errors 
exit, plus any I/O errors of the FPT error address 
class. 



If the "checked service completed in error, registers 8 and 
10 will be set as shown in Appendix N and the return will be 
to the specified error or abnormal address in the TEST FPT. 



TEST will check any service requested by any task in the 
caller's load module. 



Abnormal address is the return location for FPT ab- 
normal address I/O errors. 



Services originally requested using FPTs in registers will 
give unpredictable results on TEST. 
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8. CP-R DEBUG SERVICE 



The CP-R Debug monitor service provides Hie foreground 
and background (batch stream) user with a versatile sat of 
commands that allow the user to modify, examine and con- 
trol the execution of a job. Both primary and secondary 
tasks may use the debug service; however, only one task 
per job can have debug control at any given time. 



The Debug monitor service consists of a set of CP-R over- 
lays that are called to perform the requested Debug func- 
tions. Debug control of a task in a given job can be 
established by any of the following: 

e Debug system call. 

e Debug Key-in. 

e Debug option on INIT system call, key-in or con- 
trol command. 

e Debug option on RUN system coll. 

e Debug option on (RUN control command. 

Control of Debug is through a set of operational labels as- 
signed to the devices that will be used to input commands 
and output dumps, snapshots, etc. 



These operational labels are given default assignments at 
SYSGEN time but the user is responsible for establishing 
the appropriate assignments in the JOB to be debugged. 



Debug has provisions for accepting an unsolicited interrupt 
or break function that allows the user to interrupt or break 
out of the task being debugged and to give control to debug. 
Two methods are provided for this feature. At SYSGEN 
time the user may associate an external interrupt with a key- 
board printer (TYxxx device type). When one of these 
interrupts is received, Debug will associate the interrupt 
with a JOB using the specific keyboard printer and will 
cause any task that has Debug control to return to Debug 
for input. For primary tasks this control break function 
only occurs when the task is returning from a monitor ser- 
vice call. For secondary tasks, control can be returned 
to Debug at any time. 



The second method of causing this break function is from the 
operators console by using the BREAK key-in. 



KBUC This call will establish Debug control in the 

named task. The call has the following format 

CAJ.1,7 address 

where address points to word of the FPT shown below. 

word 



X'65' 1 



I I I ll< I t lll'l II lllil I) u UlU B II HlM !i U Hi J. IS V 0th H fc n 

word 1 



T*rT 



yo- 



li'lHli II L. tJlL 1MI illKli H HlUli J. BlfcH it 1 



optional (PI) 



Error address 



» i i Hi in i im mu u u uu » a *mi< a u\» fa h m* »a >. 
optional (P3) 



Task name 



i i > iu i i Hi i u ii i ii u u au i > it 4 i >n, a a i t. a s. gm t r u . 
optional (P4) 



Task name 



i i i rt< ! nu't ii ntu u u ui* i) 4 *ik >i u jsii«i) i. n>t w » 



optional (P10) 



Completion 

1 1 1 ff! e j « » 


n - 


u o 

1 I it III J d u aiu B 4 WIS 1< H Wi. fa fc »ltt » U J. 



optional (Pi 1) 



Job name 



8 i i iU l ♦ >U > It ll l i} » u ti l * » it w l « >. a Hlv. m. B l M » » i 
optional (P12) 



Job name 



nni.it una ii i «i u u uu w u mitu bhhhhi»hiii 



where 



WordO % 

X'65' is the code to initiate the cal I. 



DEBUG CALL 

The Debug monitor service may be invoked by execution of 
the following monitor service call. 



Word 1 



P is the error address parameter presence indicator 

(0 means absent; 1 means present). 
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v3r*A ore ftio tosk 

indicator (0 mow absent; 1 m ea n s present). 

P«* Is IIm compforton cooe parameter presence 
indicator (D moans absent; 1 moans present), 

F||— Pl2 •*• •"• f°^ name parameter presence In- 
dicators (2 means absent; 1 means present). 

F^l is the abort override indicator. If set, con- 
trol will be returned to colling instruction + 1 if 
errors are detected and no error address parameter 
has been provided. 



Word Options 

Error address is the return address if errors are found. 

Task name is the name of the task to be run with 
DEBUG. The caller's task is the default name. 

Job name is the name of the JOB in which the 
named task is being executed. The caller's job 
is the default name. 



METHOD OF OPERATION 

To make the most effective use of the provided Debug fa- 
cilities, the user should assemble, load, and run his fob 
with a knowledge of Debug functions. 



The Debug service allows the user to reference locations 
by using symbols. These symbols may be defined by the 
user at debug time and need not be related to the symbols 
in the user's programs. If the user wants Debug to intercept 
haps he should not make his own trap CALs. 



DP is the oplobel used for reading patches. The 

Input rood on DP is assumed to be in the for- 
mat described in the "Debug' Commands Used 
On Line and From Batch" section. 

DO is one of the oplabels used for Debug output. 

This is normally assigned to the line printer 
and may be used by Debug for longer outputs. 

PI, P2 are the other oplabels used for Debug out- 
put. Eoch of these can be assigned to o 
device and used for output from dump or 
snapshot commands. 



DEBUG HPUT 

Background jobs using Debug services from the batch stream 
can assign DI to the control command input. When a fob 
Is to be debugged on-line, the DI op label is assigned to a 
keyboard printer. There is only one keyboard printer allowed 
per job and this is designated the control console. Although 
Input and output may use other devices, oil on-line control 
comes from the control console. The control console may be 
a debug console or the operators console. Input may also 
come from the DP (Debug Patch) oplabel via a P command. 



When a user is debugging on-line, all unsolicited messages 
and requests for input are routed to the control console. 
An interrupt is provided at each control console to allow 
the user to initiate unsolicited input. 



Debug is normally used from a debug console. This is o 
standard keyboard printer, but it is distinct from the oper- 
ators console. It has an external interrupt level available 
for unsolicited input. 



After the user has established the Job/console/operationol 
label assignments, any INIT of a task with Debug will 
transfer control to Debug at the console assigned to that 
job. This will cause the message TASK IS XYZ to be out- 
put where XYZ is the name of the task being initiated. 
Debug then prompts with a ":". At this time, the user can 
change the prompt if desired, using the NP command. The 
user can modify the task or start execution of the task. 



Debug uses the following oplabels for communication: 

DL is the oplabel for Debug log messages. These 
include messages describing trap conditions, 
messages from snapshots and other control out- 
put. If not otherwise specified, DL will be 
defaulted to the user's debug console. 

DI is the oplabel for Debug input. All on-line 

commands are read through DI. 



The operators console can be used as a control console. In 
this case, the keyboard printer and the console interrupt 
will be shared between Debug and CP-R, All Debug output 
and requests for input are easily diseemable from CP-R out- 
put, since CP-R messages start with 1 1 and Debug messages 
start with the user-specified prompt character. The user 
will immediately know whether to respond to CP-R or Debug. 
If the user wishes to do an unsolicited input to Debug he 
should do a key-in to CP-R as follows: CINT XX, where 
XX is the hexadecimal number of the interrupt allocated to 
Debug or use the BREAK key-in. Output messages from 
Debug and CP-R will be queued and will appear on the 
OC device. * 



DEBUG OUTPUT 

Although a user can only have one control device for 
each job, he can use multiple output devices. Each sep- 
arate dump can be routed to a different output device. 
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IF no output device h specified, the output will bo done 
on tlto control comolo (DL) dovice. 



A user eon also output to any standard peripheral. The 
A oommond is used to associate devices with oplabels. If 
multiple users select the same output device from Debug, 
their output will be intermixed. The users must do their 
own device allocation to avoid mixing output. 



DEBUG TRAP CONTROL 

When a program is initiated with Debug, it connects all 
traps (X'40'-X'50') to on entry in Debug. When a trap 
occurs, Debug prints the following message: 

:TRAP XA AT SYMBOL + VAIUE 



•UU6C0MMAMD SYNTAX 

The required debug co mmand formots are the same, whether 
commands ore read from a user's debug console or from the 
patch file. All patch cords must have a command identifier 
as the first character. When Debug is used in the patch 
mode, all commands are rood and interpreted by Debug 
Immediately. Debug uses monitor CALs to do its input/ 
output. Each command must be contained on one line. 
Multiple blanb are treated as a single blank and blanks are 
used as field delimiters where shown in the commands. 



Each debug control card will be of the form: 



r 



Command Identifier options 



where 



Is the trapped task user prompt character. 

X Is the hexadecimal value of the trap. 

Y is the CC set by the trap logic. For traps 
40 and 42, CC identifies the type of trap. De- 
bug will then prompt and request input. If a 
trap occurs in DEBUG the message 

:TRAP XA at DEBUG + VALUE 

will be printed, m this ease the user's registers 
and the value of $1 will not be modified. Traps 
will occur in Debug if the user attempts to dump 
no-access memory or modify write protected 
memory. Any attempt by the user to connect 
traps will override DEBUG trap management. 



DEBUG COMMANDS 

Debug commands are provided to allow the user to modify, 
examine, and monitor the execution of his task. The com- 
mands end a description of their functions follow. 

A Assign device to DEBUG oplabel 

C Control segments 

M Modify memory 

I Insert code logically 

N Give a value to a name (symbol) 

P Read patch cards 

B Branch to the users code — move snapshot 

D Dump selected parts of core 

E Execution control (task) 

R Remove snopshot, insertion, or names 

L Look at memory for a match 

Q Quit task(s) 

S Snapshot definition 



The Command Identifier must be delimited by one or more 
bionics. 

Each control console command will be of the form: 



Command Identifier options © 



For debug commends the following definitions and conven- 
tions will be used: 

symbol From one to eight EBCDIC characters as 

described in the AP Assembler character 
set. One character must be an alpha- 
betic character. All Sigma machine 
mnemonics are reserved to Debug. $ is 
the value of the current location counter 
(first location parched) for modifies and 
inserts. $C is the current value of the 
condition codes. $F is the current value 
of the floating controls. $1 is the value of 
the instruction counter (the next loca- 
tion to execute) . 

value From one to ten numerals or hexadecimal 

values. If the number is preceded by a 
".", the number will be treated as hexa- 
decimal. A value may be preceded by 
a + or- sign. 



register I. A positive value S 15. + 

m 
2. A symbol whose value is S 15. 



loc 1 . A positive value. 

2. NAME, where NAME is a symbol de- 
fined in Debug. 
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foe 3. Sum or olffenmces of either of the 

(eont. ) above two forms. 

4. One of the above forms preceded by 
an ■*". "*1 M refen to the location 
pointed to by register 1. 



The farm of the control segments co mmand is 



[CA 
CD 

la 



seg number 



word 1. A signed (plus sign (+) optional) hexa- 

decimal or decimal value. 

Examples: -6, 100,. Ik, -.AF. 

2. A name plus or minus on optional off- 
set. The offset can be either a hexa- 
decimal or decimal value. Address 
resolution for the name can be speci- 
fied by using the AP Assembler charac- 
ter set notation: rr(name)± offset where: 

rr » BA, HA, WA, or DA 

Word resolution is assumed by default. 
Note that both BA(ALPHA) + 3 and 
BA(ALPHA + 3)are legal. If the name 
specified has not been defined some- 
where in the task, it will be flogged 
a* undefined. 

3. An EBCDIC constant (limited to four 
characters contained in quotes). Trail- 
ing blanks will be provided. 

Examples: 'ABC', 'A'. 

4. A symbolic instruction. The mnemonic 
field of the instruction must be on 
EBCDIC operation code. The register 
and index fields can be any location 
in the proper range. The address field 
can be any location in the proper range. 



The following commands are provided by Debug: 

A The assign command is similar in function to the 

STDLB cal; it changes the assignment of a Debug oplabel 
on a job basis. 



The form of the A command is 

A 



A oplabel [,area] ,name 



where 

oplabel 



is a Debug oplabel. 



area Is a RAD area if the label is being assigned 
too RAD file. 

name specifies a physical device name, a num- 
eric zero, the name of a RAD file (if area is 
specified), or another oplabel. 



where 

CA activates the desired segment. 

CD deactivates the desired segment. 

CE erases the desired segment. 

■eg number if the unique number of any valid seg- 
ment in the task. A segment must be active be- 
fore any patching in a segment can be done. 

M The modify command replaces one set of locations 
by another set. 

The form of the M command is 



( 



M loc/word-[/word./. . ./*ordl 



where 
loc 



is the first memory location to be modified. 



word; is the content to be inserted in the designated 
location. The i th word is inserted into loc + i. 



I The insert command designates insertion of one or more 
instructions logically before OB), after (IA), or replacing 
(IR) the instruction at the designated location. 

The form of the I command is 



where 

IB 
IA 

IR 
loc 



loc/wordJ/word.. . ./word } 



designates Insert Before. 

designates Insert After. ** 

designates Insert Replace. 

Is the location that insertion is done with re- 
spect to is the i th change that is to be logic- 
ally inserted. 

The information for the insert is maintained so that 
en insertion maybe removed if desired. 
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■ The name com m and associates a word (value) with 
a symbol In the currently open task or evaluates an expres- 
sion and returns a hexadecimal value. This co mmand can 
alto change the Debug prompt character for a task. 



The form of the N command is 



dump it of the form 



N 
NP 
INL 



[symbolj/word] 



where 



N specifies associate a symbol with a word value. 

NP specifies the first character of the symbol as 
the new prompt character. 

NL specifies evaluate the word. 

symbol is any AP symbol. 

word is any valid expression as described previously. 



P The patch command causes Debug to read patch cards 
from the DP oplabel. The form of the P command is 



Yn) 



loc 



J, |loc 2 | [,fermatX oplabel]] 



where 
loc 



. is the (tart location of the dump in 

the currently open task . 



loc- is the last location to be dumped if 
the command is DL. If I0C2 is not speci- 
fied, only loc. will be dumped. 

size is the number of locations to be dumped 
in a D command. If not specified, the de- 
fault size is 1. 

format is one of the following: 

E for on EBCDIC format dump. 

D for a signed decimal format 
dump. 

B for a binary format dump. 

F for a hexadecimal format 
dump. 

If no format character is present, the dump will 
be defaulted to hexadecimal. 

oplabel is one of the defined Debug 

oplabels. 

If no oplabel is present, the dumps will be 
output on the DL oplabel. 



where 

P causes a read from the DP device. 
PE returns control to the DI device. 



Debug will continue to read from the DP oplabel until it 
encounters a PE command or an EOD. 



D The dump command allows selected areas of core to 
be output. 

The form of the D command is 



I I IDLJ dOT PiLVdump 2 .../dum Pn ] 



If the D co mma n d has no arguments, the next sequential cell 
(following the last dumped cell) will be dumped. 



E The execution control command allows the user to stop 
and start a task in his job. 

The form of the command is 



,/fEHI . . 

r l_. I task name 



where 
EH 



designates execution halt (stop). "Us 

This command causes a STOP CAL to be done to 
the task. This will Inhibit the named task from 
further execution until a START is done. 



where each dump after the first one must be preceded 
by a "/". 



EB designates execution begin (start). This will 
start a secondary task via o START CAL. 
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I The remove function will remove either snapshots 
or Insertions and replace tha original contents of fhe 
location (s). 

le form of the R oommond it 



R 

RS 
RI 
RN 



loc^/locj/. . ./loc n ] 



where 



R specifies removal of an/ snapshots or insertions 
in ioc] through Iocr. 

RS specifies removal of all snapshots. 

RI specifies removal of all insertions. 



RN 



specifies removal of all names. 



loc. are the locations where removal Is to be done. 
1 When the removal is done, the location it returned 
to its original state and the patch it removed from 
the Debug work space. No locations are allowed 
for either RS or RI commands. Inserts may not be 
placed over a location already accommodating an 
insert or snap. 



B The branch command is used to start execution at the 
specified location in the currently open task and to move a 
snapshot if desired. 

The form of the B command is 



|* M }[snaploc],[loc] 



where 



B designates a branch to loc. If no arguments are 
present, the task will continue from the current 
active snapshot or program start ($1). This option 
allows the user to continue from a snapshot or start 
at the entry of o newly initialized task. The snap 
loc parameter will be ignored if present. 

BM designates branching to loc and moving the 
snapshot location. This command should be used 
only when control has been transferred via a snap- 
shot and breakpoint. The BM will move the snap- 
shot from its original loc (L) to the specified snap 
loc and execution will resume at the specified loc. 
If loc is not specified it defaults to L. If neither 
argument is specified, loc defaults to the original 
loc (L) and snap loc defaults to L ♦ 1. This gives 
the user a stepping function which allows him 
to execute instructions line by line. This com- 
mand with no arguments will not allow the user 



to stop o branch Instruction. K It it desired to 
continue execution from the current snapshot and 
move the snapshot the command "BM snap loc" can 
be used. 



L The look command allows the user to search memory 
for a certain pattern. 

The form of the L command is 



c 



L loc^locVwordjf/wordjJ 



The search will be conducted between locj and loc2 for a 
match to word] . Each location will be masked (logical and) 
by word2 before being compared wordj. If word2 is not 
present the default will be X'FFFFFFFF'. All locations that 
match and their contents will be printed on the control 
console. 



ft The quit function allows the user to terminate a single 
task in his job or to terminate the whole job. 

The form of the Q co mm and is 



4li 



where 

Q terminates the named task. 
QJ terminates the entire job. 



V The W command allows the user to compress debug 

workspace and moke returned space available for extensions 
by name, insert, and snap commands. Should there be snaps 
or inserts associated with currently nonexistent or protected 
space, the squeezing will be incomplete and will return an 
error report. 



■EBUG SsUKMOT 

There are two types of snapshots that can be specified. The 
snapshot and continue does the dumps if Required, and con- 
tinues execution after the snapshot. The snapshot and break- 
point executes the snapshot as above and tflen goes to the 
control console for input. Either type of snapshot can be 
specified in patch co mmands. 



S The S command inserts (in the same manner as the com- 
mand IB) a snapshot at the designated location, so that when 
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control poms through fho location, th« following transpires 
prior to executing fho instruction that was at loc: 

The following it output on tho DL oplabel. 
:SNP AT loc 

where • 

b the prompt eharoeter for the task where the 
•nap is. 

loc is the location specified in a previous S command. 

The form of the S command is 



j_ r | loc /dump requests 



where 



S is o request to snapshot and transfer control (snap- 
shot and breakpoint) to the control console for De- 
bug input. 

SC is a request to snapshot and resume execution. 

loc is the location in the task where the snapshot 
is to be placed. The location cannot already be 
associated with an insert or snap. 



Pump requests are the same format specified in . 
the D (Dump) c o mmand. Each dump specification 
must be preceded by a "/*. Only five each re- 
quests may be accommodated. 



DEBUG ERROR MESSAGES 

A message is output for all Debug errors. Debug will then 
request input from the Debug control console. The follow- 
ing message is output to the control console. 

ERR N IN FIELD M 

where 

N is a hexadecimal value between 1 and FFF. All 
errors in the range FFO to FFF are system errors and 
indicate a system malfunction. Other errors are 
user errors. 

M is a decimal value that indicates the field where 
the error was detected. The first error found will 
abort the command. In reporting the field count, 
Debug considers the command identifier to be 
field 1. Each subsequent delimiter, including 
blonk/+ - ()., '* terminates a field. 

Al I errors ere detected before the command has 
been processed except those indicated below by 
an *. The indicated commands are processed up 
to the point of the error. The command it then 
aborted and further input is requested. 

The Debug error numbers and their meaning are itemized 
in Table 18. 



Table 18. Debug Error Messages 



Error 






Number 


Description of Error 




11 


An empty field after a delimiter is invalid. 




12 


A. followed by a nonhexodecimal value is illegal. 




13 


The indicated field should be a number or a defined symbol. 




14 


Invalid address resolution has been used. 




15 


An illegal left parenthesis has been used. 




16 


A right parenthesis is followed by illegal syntax. 




17 


An illegal EBCDIC constant has been specified. 




22 


Illegal hexadecimal value has been specified. 




27 


Undefined symbol. 




2B 


Illegal eharoeter. 




31 


Register and address field missing. 


\ 
« 


32 


Register missing. 


33 


An * is illegal in the register field. 




34 


A register designation must be followed by a blank. 




35 


An empty address field is illegal. 




36 


The index field is missing. 




37 


An * is illegal in the index field. 




38 


The specified index is too large. 
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(cent.) 



Error 
Number 



Description 



39 
41 
42 
43 
51 
52 
53 
54 
61 
62 
64 

71 
81 
82 
83 
89 
8A 
86 
8C 
91 
92 
Al 
A2 
A3 
81 
82 
CI 
C2 
C3 
C4 
C5 
CE 
CF 
Dl 
D2 
El 
E2 
Fl 
F2 
F3 
F4 
101 
102 
111 
112 
121 
122 
131 
132 
,133 
134 
1F1 
1F2 
1F3 
FF1 
FF2 



The specified register voloe is Illegal. 

No location has boon specified. 

No words have been specified. 

Too many modifies or inserts have been specified. 

Illegal format specified. 

Illegal size in a D command. 

Illegal oplobel specified. 

Illegal use of indirection. 

More than two continuation records have been input. 

The command identifier is undefined. 

The input command is illegal from the Patch (DP) device. Delete snaps, or inserts to release 

space. 
No more work space available. 

The named location contains neither an insert nor a snapshot. 
RS and Rl commands cannot have arguments specified. 
R commands must have arguments specified. 
Workspace already compact. 
Workspace has unidentified block. 
Snap or insert linkage inaccessible. 

Program link to snap or insert is inappropriate. -. 

Invalid leading delimiter in the Dump command. 
Invalid oplobel specified in a dump command. 
No segment specified. 
Illegal segment. 

Illegal completion status from the CAL. 
An insert to a register is invalid. 

An insert or snapshot is already present in the specified location. 
A location must be specified for a snapshot. 
A snapshot to a register is invalid. 
The delimiter after the location is invalid. 
A snapshot or insert is ahead/ present. 
Too many dump requests. 
The Messoge option is not allowed. 
The condition option is not allowed. 

The delimiter after the location is invalid in a BM command. 
No snapshot is active. 
Stort, end, or word 1 are not present. 
The delimiter after start, end, or word 1 is illegal. 
Illegal character in the named symbol. 
A value must be specified in an N commond. 
The delimiter after the symbol name is illegal. 
An NL command must have an expression. 
Illegal character in Task Name. 
STOP/START error. 
Illegal character in Task Name. 
SIGNAL Error. 

Illegal character in Task Name. 
Error in TERM call. 
Illegal Oplobel. 

Illegal Delimiter. ** 

Illegal File Name. 
Error inSTDLBcall. 
Write Error (DL). 
Read Error (DI). 
Write Error. 

A patch element type is too large. 
A patch element size is too large. 
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a CP-R MEDIA SERVICE 



The CP-R MEDIA service provides the operator facilities 
for performing media conversions concurrent with the op- 
eration of foreground and background jobs, and foreground 
tasks the ability to submit permanent disk files for later 
printing on a line printer. 



KEY-M CONVERSIONS 

The MEDIA key-in allows the operator to request conver- 
sions from 



file I 
rape 
cords J 



file 
tape 
printer 
punch 



or from file to keyboard printer. 

Multiple key-in requests may be mode. Each request will 
be queued for later processing. 



MEDIA performs its conversions as an independent task in 
the CP-R job concurrently with other tasks in the system. 

Each conversion request, as It is entered into the queue, 
is assigned an Identification number. This number is typed 
on the operator's console (OC) device for key-in requests, 
and is used to identify output for the request. Printer out- 
put will be identified by a break poge containing the name 
of the requesting task (this will be "OPERATOR" for key-in 
requests) and the identification number. 

Queued requests are processed in the following order: 

1 . Key-in requests; 

2. Service requests, by priority. 



When the Symbiont processor Is in use for Background jobs, 
MEDIA will coordinate with the Symbionts for usage of 
devices common to both. Any requests to use a device 
already in use by the Symbionts causes that request to be 
delayed until the device is free. All devices used by either 
processor ore freed <a the end of each job or request to 
allow the other access. This insures that a job's or con- 
version's output will be contiguous and not intermixed with 
other output. Outputs may alternate between MEDIA and 
Symbionts. 



FOREGROUND CONVERSIONS 



For the foreground tasks, the MEDIA service call provides 
a delayed printing mechanism. The task can output printer 
destined information to o permanent disk file, and request 
the MEDIA task to copy the file to the printer. Multiple 
requests can be mode by one or more foreground tasks 
causing the requests to be queued for later processing. 

Requests from a foreground task's service call do not 
explicitly state the destination of the printed output. The 
destination is implicitly the MO operational label in the 
CP-R job. The default assignment of the op label is deter- 
mined during System Generation (SYSGEN), but may be 
changed by the STDLB key-in. 



MEDIA PROCESSING 

MEDIA handles oplabels in a slightly nonstandard manner. 
Oplabals ere converted to the device or file to which they 
are assigned. This is done by the key-in when the request 
is accepted and for a foreground service request when it 
is ready to be processed. This means that changing the 
assignment of an optabel during a MEDIA conversion has 
no effect on that conversion. This is done to protect the 
integrity of a MEDIA output. 



MEDIA SERVICE CALL 

MEDIA The Media service call allows foreground 

tasks to submit permanent disk files to the CP-R Media task 
for later processing. The Media task, when processing the 
request, will copy the file to the MO operational label as 
defined in the CP-R job. 

The call for this function has the following format: 

CALl,7 address 

where address points to word of the FPT shown below 

wordO 



X'59' 



0—0 



DCB address 



i i i i i « i * m'rin il nu uwu p h » i mm m*. fe k g t h h k » 



word 1 














4 


TT 




1 




1 


4 

1 


0—0 

TTT 


* 




1 


f 
to 

i 


0-0 

TB-rrhr 


M 

u 




'u Blu p ■ wig »i g Bin is % pin » n' 



optional (PI) 



■mtTTTT 



Error address 

I I ■ H l H B U U l U » It f l » il g B i t. H Si g l H * % i 
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optiono! <P4) 


-• 


• 




Aim ana filo humc oooross 





optional <P8) 



Priority 



H i i iu i i > u i hhim u uh I n, » a mm. b g i i. « h »i » ■ g i 
optional (10) 



Completion 
Code 



optional (14) 



1 account name address 
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HO b the poramotor presence Indicator lor the 
optional typo complatlon cod* poramotor (0 indi- 
catot no potting; 1 Indicatot tKo completion code 
is to do potted} « 

P14 It the account name address parameter presence 
Indicator (0 meant absent; 1 means present) . 

F7 Is the abort override Indicator. 



Word Options 

Error Address Is the return address to process any 
detected errors* 



whore 



P 



WordO 

X'59' it the code that tpecifies the media call. 

DS Is the double space option that is meaningful 
only when NVFC =1. If present (DS = 1) the 
printed output will be double spaced between 
each line of output. If DS is zero (0), then tingle 
spacing will occur. 

NVFC is the vertical format control option. If 
present (NVFC = 1) then printer output will take 
place as specified by the DS parameter. If NVFC 
is zero (0), then the First byte of each line image 
is interpreted as a format control character. 

DEL is the delete file after printing option. If 
present (DEL = 1) the RAD file specified to be 
printed will be deleted after the printing opera- 
tion has successfully been completed. If DEL is 
zero (0), the RAD file will not be deleted. 

DCB address if parameter P4 in word 1 is not 
present (=0), then this field is interpreted as 
the address of a DCB that is assigned to the RAD 
file that is to be printed. If the DCB is not as- 
signed to a RAD file, then an error condition 
is generated. 



Word 1 

PI is the optional error address p aram e ter presence 
Indicator (0 means absent, 1 means present). 

P4 is the parameter presence indicator for the 
optional file name and area address parameter 
(0 means absent; 1 means present). 

P8 is the parameter presence indicator for the 
optional priority aerometer (0 meant absent; 1 means 
present). 



Area and File Name Address is the address of a 
three word data block that contains the area and 
file name of the file to be listed. The first word 
contains the area name in bits 16-31 in EBCDIC. 
The second and third words contain the file name 
in EBCDIC. 

Priority is the 16-bit priority which is to be as- 
signed to the printing operation. This priority is 
used to control the selection of files to be printed. 
If not specified, priority defaults to the callers 
priority . 

Completion Code is the word where the system will 
post the results of the service call. 

account name address it the address of a two word 
data block that contains the account name in 
EBCDIC, extended to eight characters with trailing 
blanks. If the account name is all blanks or nu- 
meric zero, it Is treated as unspecified. 

a. If neither account name nor area name is spec- 
ified, the calling task's account is used, and 
the area may be any public area. This pro- 
vides the simplest specification, and the user 
need not be concerned with the possibility of 
name conflicts other than within his own 
account. 

b. If the account name is specified, but the area 
name Is not, the file may be in any public 
area. This provides for area-independent file 
specification . 

c. If the area name Is specified but the account 
name Is not, the system account will be used. 
This case provides compatibility for code 
written before the addition of file account 

flQTTt0$e 

Note: If a DCB address Is supplied in lieu of the area and 
file name data block, the DCB will be closed upon 
successful processing of the MEDIA service call. 
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MEDIA BY-MS 

Ih« MEDIA key-in has two function*; it allows tho operator 
to submit requests for a Media convorslon and it gives him 
control ovar the operation of the Media task. 

The MEDIA key-in has the following general format: 

MEDIA (input specification)^ (input option), 

' (input option), . . .] , (output specification 

L— [, (output option), (output option),. . JJ 

MEDIA (control specification^ (control 



or 



' specification), . . .] 

where 

Input specification may take any of the following 
forms: 

IN, device 
IN, oplabel 
FILE, fid 

Device may be a card reader (CRxxx) or a magnetic 
tape (9Txxx or 7Txxx). Oplabel must be associated 
with one of these devices or a file. 

Input option may be one of the following: 

, DEL SFILE, n UNLOAD 

ALL REW 

The DEL input option is applicable only to a file input 
specification and indicates the Tile is to be deleted 
after the copy is successfully completed. 

The ALL option is applicable to rape and cord input 
specifications and indicates that all files from the 
starting file to the end-of-file (volume) or two con- 
secutive lEODs are to be copied. 

The other options ore applicable only to magnetic tape 
devices and specify processing as follows: 

SFILE, n space forward from the starting (current) 
position "n N files before starting the copy. 

REW rewind the input tope after the copy 
operation is completed . 

UNLOAD rewind the input tape "off-line" 
after the copy operation is completed. 

Output specifications may be of the form: 

OUT, device 
OUT, oplabel 
FILE, fid 



Device may be a tape (9Txxx or 7Txxx), a printer ' 
(LPxxx), or a cord punch (CPxxx). Oplabel must be | 
associated with one of these devices or a file. If a 
file Is specified as Input, then a keyboard printer may 
be specified as an output device (TYwcx). 

Output option may bo one of the following: 



NVFC 
SPACE, n 
ADD 



SFILE, n 
WEOF,n 



REW 
UNLOAD 



The NVFC and SPACE, n options are applicable to 
printer destined files and have the following meanings: 

NVFC the first byte of each record is not to 
be interpreted as a VFC byte; instead, it is 
to be printed as data. The default is the 
first byte is used as a VFC byte and the data 
starts in the second byte . 

SPACE, n this has meaning only when NVFC 
is specified and indicates there are to be 
"n" blank lines between each output line, 
1<n<15. 

The ADD option specifies that the output file(s) is 
either to be an extension to an existing disk file or to 
follow the last file currently on a magnetic tape. 

The remaining options are applicable to magnetic tape 
and specify processing as follows: 

SFILE, n space forward from the starting (cur- 
rent) position "n" files before starting the 
copy. 

WE OF, n write "n " ond-of-files after the copy . 
If WEOF is not specified, "n" Is defaulted 
to 2. 

REW rewind the output tape after the copy . 

UNLOAD rewind the output tape "off-line" 
after the copy. 

Options which do not have meaning for their associated 
Input or output specifications are accepted and ignored 
without an error notification. 

The control specification may be one of the following: 

S 
L 
I 
X «*■ 



where 



S causes an immediate suspension of the cur- 
rent copy operation . 

L will inhibit the initiation of any new copy 
operations but will allow the current copy to 
continue . 
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1 continue the currant copy if sto pp ed vie on 
"S", remove the previout "L" request, or 
•eorch for a new copy to start. 

X terminate the current copy. 



. Specifying an SFILE, n count greater than the number of 
files remaining on o tape will eouse the output file(s) to 
be oppended os if on ADD hod been specified. 



Multiple control options may be selected in any order 
In one MEDIA key-in. However, if on "S" and/or "L" 
ore selected in combination with on "I", processing is 
os fellows: The "S" and/or "I" action requests are set 
(combined with the current status of the MEDIA task); 
then, if "S" is set, "1" resets it only; if "S" is not set 
ond "L" is, "I" will reset "L". 



CONVENTIONS 

Input files are delimited by a IEOD from a card reader, 
an end-of-file from a tape, or the end^of-file from a 
disk. When multiple files are being copied in response 
to the ALL option, double lEODs or end-of-files are 
required to terminate the input. Tapes being processed 
in response to ADD or ALL options must be terminated by 
double end-of-files. 



Whenever one of the devices involved in a MEDIA copy 
requires operator intervention, a message indicating this 
condition will be output on the control console and the 
MEDIA task will enter the suspended operation state by 
simulating an "5" control key-in. This message moy be: 



I (MEDIA: MOUNT TAPE(S) FOR dddd 

to indicate the tape or topes for conversion request "dddd" 
ere to be mounted; or 



I lyyndd MANUAL 
to indicate that the device is in the manual state; or 

I lyyndd WRT PROT 
to indicate the output device is write-protected. 

The copy is continued after the condition Is corrected by 
entering the MEDIA "I" control key-in or aborted if me 
condition cannot be corrected by entering both the "X" 
and "I" control key-in. Note that if the "X" end "I" are 
not entered in one key-in, the "X" should be entered first 
to prevent a reoccurrence of the condition. 

Multiple positioning options may be requested for magnetic 
topes that might cause conflicts. If both SFILE and ADD 
are specified for an output tape, the SFILE positioning is 
performed first ond then the ADD positioning. Whenever 
both REW and UNLOAD ere specified, only the UNLOAD 
is performed. 



MESSAGES 

The acceptance of a valid key-in request and its entry into 
the MEDIA task's queue is indicated by the message, 

I (QUEUED AS ID NUM dddd 

A key-in request that is rejected for any reason is indicated 
by the message, 

IIKEY-ERR 

end can be corrected by re-entering the correct key-in. 

The message, 

I (MEDIA; MOUNT TAPE(S) FOR dddd 

is typed when the MEDIA task has begun processing request 
"dddd" and will wait until the operator indicates he has 
mounted the correct tape(s) on the correct drives. 

The message, 

1IMED1A: ABORTED REQ dddd:yyyy[, xx] 

is output whenever e copy request cannot be completed 
normally and is aborted. The "dddd" gives the request's 
ID number, "yyyy" gives the reason for the abort, and 
the optional "xx" gives the error code returned in RIO by 
the service call reporting the fatal error. The meaning of 
the various "yyyy" codes moy be one of the following: 



yyyy 

BUFS 
DEV 
NO MO 

OPER 

OPNI 

OPNO 

PREP 

SPEC 



Meaning 

unable to get memory for buffers. 

unrecoverable error during the copy. 

the MO operational label was not defined 
by SYSGEN time. 

the operator keyed in the "X" control 



finable to open the input file. 

unable to open the output file. 

fatal error during SFIJ^E or ADD ore-copy 
positioning. "1 

an error in the request specification that was 
not detected when request was accepted. 



These errors will have the optional "xx" displayed. 
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OVERVIEW 

The Overlay loader h a two -pot* processor that creates 
program in overlay form. Modules in standard object 
language format are converted to overlays in absolute 
core image form in accordance with the Loader control 
commands. The Loader creates programs for execution in 
either foreground or background, prepares standard proces- 
sors for execution under the Job Control Processor, and 
creates Public Libraries. 

The Overlay Loader permits the user to assemble, load to 
background or foreground and execute programs with mini- 
mal control information. The default cases documented in 
this section for each control command will handle most nor- 
mal situations. 

The control command structure permits the user to tailor the 
loading procedure for a wide variety of situations, and the 
control commands add control and flexibility by overriding 
default cases and adding options. 

The size of the program that can be loaded is a function of 
the size of the symbol table and available core storage at 
load time, rather than the amount of core memory that the 
program occupies at execution time. Therefore, the Over- 
lay Loader may load user programs equal in size to the max- 
imum available areo in core at execution time, even though 
this area is not available at load time. 

The loading of mixed medio is allowed, and all library 
loading will be from library files on disk. There are no 
constraints on the ordering of modules within o library. 



FUNCTIONAL n0W 

The options specified on the I O LOAD control command an 
scanned and those not specified are assigned their default 
values. A :ROOT or :SEG control command is scanned to 
determine the source of the binary object modules from which 
the segment will be created, and to define its linkage. 

The Loader makes the first pass over the binary object mod- 
ules, allocating the segment's labelled COMMON blocks 
(dummy sections) and control sections. It concurrently builds 
a symbol table of DEFs and unsatisfied REFs. Object mod- 
ules input from non-disk devices are saved on a temporary 
disk file (XI). 

After the last abject module for a segment has been input, 
the libraries are searched. Pointers to the selected library 
object modules are soved and their DEFs and REFs are added 
to the symbol table. At the end of a path, segment symbol 
tobies are written on temporary disk files. At this point 
all the Loader control commands except : ASSIGN and 
:LMHDR have been input. 



During the second pass, each segment's binary object 
modules and selected library modules are loaded. The 
absolute core image of each segment is created and written 
on the program file. Part two of the ROOT (the DCBTAB, 
OVLOAD table, the temp stacks and any DCBs created by 
the Loader) is built at the end of the second pass. If o MAP 
has been specified, it is output. V an output file used by 
the Loader overflows, an attempt is mode to output all pos- 
sible MAP information. The Loader returns to the system 
by calling either the EXIT or ABORT function. 



UMITATONS 

There ore certain limitations in the use of the Overlay 
Loader due to the total system considerations or because the 
efficiency of the Loader could otherwise be degraded. 

1. No discontinuous segments will be output by the Over- 
lay Loader. The SEGLOAD and ACTIVATE service 
functions read only contiguous core images. Since 
each discontinuity would result in at least one addi- 
tional disk access, considerable degradation of the run- 
load process for the foreground would result. 

2. The contents of reserve areas within a program will not 
be predictable at execution time unless initialized in 
some monner (e.g., by DATA statements). Labeled 
COMMON will be unpredictable unless initialized by 
a DATA statement. Blank COMMON is not written to 
disk and is not loaded as part of the program. 

3. Allocation of program and labeled COMMON within a 
program area is generally determined by the Loader. 

4. Only relocatable modules or those containing absolute 
origins falling within the limits of the segment currently 
being loaded will be allowed. 

5. No implicit loading of segments will take place at exe- 
cution time. Only explicit calls for Memory Manage- 
ment services will read in overlay segments. Thus, 
the overlay structure must be accurately defined at load 
time to coincide with explicit calls in the user's pro- 
gram. The user may, however, specify a set of seg- 
ments to be loaded initially. 



OVERLAY LOAD MODULES 

An overlay load module is a file containing the absolute 
core images of the segments of a program, along with a 
body of information to control the preparation of the pro- 
gram for execution. The absolute core image of a segment 
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in the load esodule It a single continuous byte tiring, 
beginning at a sector boundary. Its length is such that it 
includes all areas of lh« segment generated from ROMs and 
all locations altered by MODIFY commands. It will stop 
short of any areas at the end of a segment that result from a 
:RES command if these areas do not have specific initial 
contents (i.e.. If there are no :MO0IFY commands affect- 
ing them). 



OVERLAY STRUCTURES 

An overlay program is generally composed of two root seg- 
ments, a Blank COMMON segment and several overloy 
segments; however, it can consist of as little as a single 
root with no other segments. The root and common segments 
are always resident during execution of the program. 
Residence of overlay segments depends on the explicit use 
of Memory Management calls by the program. 

Each segment is created from one or more binary object 
modules and associated library routines. The segments are 
assigned arbitrary identification numbers (except for the 
root, which is always segment 0) that must be unique within 
the overlay program. Segment numbers are used by the 
Overlay Loader and the Memory Management fuetions. 

The overlay structure of the program is communicated to 
the Looderwith the :ROOT, :SEG, ond :COMMON con- 
trol commands. This structure defines all sets of segments 
that logically may be in memory together. Any such set 
of segments will be called a "path" of the program. The 
overlay structure of a program is commonly represented by 
a tree diagram, where the root (both segments) is the origin 
branch and each overlay segment is a branch. The diagram 
is drown so that the paths of the program are the same as 
the sets of segments defined by the paths through the 
diagram. 

The overlay program example given in Figure 13 consists of 
a root (segment 0) and overloy segments 1 through 15. The 
segments (horizontal lines) are numbered in the order in 
which they were built by the Loader. There ore nine paths: 



1. 0,1,2 

2. 0,1,3 

3. 0,4 

4. 0,5,6,7 

5. 0,5,6,8 



6. 0,5,9,10,11,12 

7. 0,5,9,10,11,13 

8. 0,5,9,10,14 

9. 0,5,9,15 






1 


2 




* 




3 




4 








5 


6 


7 








8 




12 


9 


10 


11 ' 
14 




13 




15 









Figure 13. An Overloy Program 



OVERLAY RESTRICTIONS 

Communication between segments by external DEF/feEF link- 
ages is permitted with the following restrictions: 

1. The Loader will satisfy a DEF/REF linkage only within 
a path. 

2. A segment in one path cannot reference a segment in 
another path. For example, segment 2 must not refer- 
ence any of segments 3-15. 

3. The user must ensure that any segments that intercom- 
municate are in core. For example, if segment 5 ref- 
erences segments 6 ond 8, then segments 6 and 6 must 
have been explicitly loaded. If segment 8 references 
segments 5 or 6, these segments must hove been explic- 
itly looded since the loading of segment 8 does not 
cause the implicit loading of segments 5 and 6. 

4. Identical definitions cannot be used in segments that 
are in the some path. For example, segments 5 and 13 
cannot have identical definitions be couse they are both 
In path (0,5,9,10,11,13). 



Normally, the allocation of memory to the segments of the 
progra m would Correspond to the structure diagram above. 
Each segment would begin in memory at the end of the seg- 
ment at which it is based in the diagram. This allocation is 
provided by the Overloy Loader when segment origins are 
not specified explicitly. 



Identical definitions and references moy be used in seg- 
ments of different paths that do not involve a common 
segment. For example, tf segments 7 ond 15 reference 
Identical definitions in segments 6 and 9, the Loader 
will link the reference in 7 with the definition in 6 ond 
the reference in 15 with the definition in 9. 
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6. Idonticoi references in segments o? exffieeent potte may 
be mode to a definition in a s egment common to both 
paths. For example, segments 6 and 9 can each refer- 
ence o definition in segment 5 because 5 is a common 
segment in the two paths (0, 5,6,7) and (0, 5, 9, 10, 14). 

7. A segment that is common to two paths cannot reference 
identical definitions in the different paths. For exam- 
ple, segment 10 cannot reference identical definitions 
in segment 12 and 13, even though segments 12 and 13 
are in different paths. 

Where possible, the Loader will worn the user about errors 
in overlay structure and segment communication; however, 
it is the user's responsibi lity to attempt a reasonable, work- 
able overlay construction. 



OVERLAY CONTROL COMMANDS 

The prime Overlay Loader command, 1 OLOAD, is read by 
the Job Control Processor (JCP) and causes the Overlay 
Loader processor to be read into the background and exe- 
cuted. All Loader subcommands are Identified by a leading 
colon (e. g. , :SEG). They are reod from M:C and logged 
onto M:LL. Blank cards are passed over without comment. 
When o CP-R control command is encountered, the Loader 
completes the load process and exits to the JCP. 

Note that IEOD must occur only as a terminator for object 
module input; its use is illegal for terminating the Loader 
control command stack. 



SYNTAX 

The syntax for Overlay Loader control commands is identi- 
cal to that defined for job-control commonds (except for 
MODIFY). 



iLMHDR co mmands must follow all ether commands. A 
sCOMMON command may occur (only once in the command 
stock) wherever a *SEG substock is legal, except following 
a :PUBLIB substock. Only o single :SEG substock may 
follow a :PUBUB substock. 

A ROOT or SEG substock has the following order: 



ROOT or :SEG 

INCLUDE 

EXCLUDE* 

LIB 

LCOMMON f 

RES 



Binary Object Module . 



Binary Object Module 
jMODIFY 



These commonds may occur 
In any order. 



Binary object modules ore in- 
cluded at this point in the 
substock only If the input 
device specified on the 
preceding :ROOT or :SEG 
command is the same as the 
"C" device. 



:MODIFY 
The PUBLIB substock has the following order: 



PUB LIB 
INCLUDE 
EXCLUDE 
LIB 



Binary Object Module. 



Binary Object Module 
:MODIFY 



These commands may occur 
In any order. 

Binary object modules are 
included in the substock 
only if the input device 
specified on the PUBLIB 
command is the some as 
the "C" device. 



ORDER OF CONTROL COMMANDS 

The control command stack is divided into major divisions 
or substacks, which must occur in the following order: 



:ROOT 
SEG or rCOMMON 



SEG w COMMON 

ASSIGN or :LMHDR 



I OLOAD 



i: 



PUBUB 
SEG 



MODIFY 



IOLOA0 The I OLOAD control command signifies that 

the Overlay Loader Processor is to be executed in the bock- 
ground areo. Any error on the I OLOAD control command 
causes the Loader to abort. Recovery consists of correcting 
the error and reloading the entire job. 

If an I OLOAD control command is continued tp^onother 
card, the continuation command must hove a colon (:) in 
column one instead of an exclamation (I) character. 



The :UB, :INCLUDE, :RES, and :MODIFY commands may 
occur in any :ROOT or :SEG substock. tEXCLUDE and 
tLCOMMON may occur in a :ROOT substock, or in a :SEG 
substock unless it follows :PUBUB. The sASSIGN and 



These commands are not permitted in a :SEG substock if it 
follows a :PUBUB substock. 
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The form of the 



it 



r 



IOLOAD [feftfon j JCopHong). . . Coption^] 



{backK^^'^ 1 ^ 



where the options ere 

GO specifies that the Loader it to Input all object 
modules from the GO file and form a root. The 
only other control commands recognized in this 
mode are :RES, INCLUDE, -.MODIFY, and 
ASSIGN. All other comm a nd s ore considered 
illegal . This is considered the default input op- 
- tion unless the first command following the 
OLOAD command is either :ROOT or rPUBLIB, 
which provide their own input specifications. 

GO, LINKS specifies that the Loader is to form a 
link type overlay structure from GO In the follow- 
ing manner: module 1 is identified as the root 
(segment 0); module 2 is identified as segment 1 
and is linked to the not, . . . ; module n is iden- 
tified as segment n-1 and is linked to the root. 

Module 2 (ident 1) 



Module 1 (root) 



Module 3 (ident 2) 



Module n (ident n-1) 



Libraries are searched at the end of each segment . 
Only :MODIFY and sASSIGN commands are hon- 
ored. The user must make explicit calls to load 
segments 1, 2, . ..n. No implicit calls are built 
by the Loader . 

PUBLIB,name][,name2,name3/iame4] specifies that 
the named Public Libraries ore to be resident when 
the loaded program executes, and that the Loader 
Is to establish the appropriate linkoge. Name; 
is the file name of a Public Library in the Fore- 
ground Programs area of the disk. The PUB LIB 
keyword may not be used when a Public Library 
is being created. (3. e. , one Public Library can- 
not reference another Public Library.) The class 
of the task(s) constituted by the program to be 
looded must march that of the libraries referenced 
(i.e., primary or secondory). 

UB[,USER,SYSTEM] specify the Libraries to be 
searched following each segment. The order of 
the keywords USER,SYSTEM defines the order of 
the search. If the USER or SYSTEM keywords are 
omitted, and only the UB keyword Is specified, 
the Library search is suppressed. IT the LIB option 
is omitted, the Loader searches the System Library 
after each segment. 

Note: The :UB control command overrides this 
option for the segment in which it appear s 
(see below). 



eif ies whether the 
program being loaded 
Is to execute in foreground or background. If 
the option is omitted, the program will execute 
in the background. The "fwo" and "Iwa" pa- 
rameters are hexadecimal values denoting the first 
word address (on a doubleword boundary) and last 
word address of the area within which the program 
will execute. If REL appears, "fwa" and "iwa" 
denote word displacements of the program limits 
from the default first word address described 
below. 

For primary programs, the default fwa and Iwa 
values are the FWA and LWA of the first Fore- 
ground Private partition (defined at SYSGEN). 

For secondary programs, the default limits are the 
limits of task virtual memory. Note that "Iwo" is 
an indicator of upper limit. 'If the program exceeds 
this limit, the user is warned but loading is not 
inhibited (except when a Public Library is being 
created). If the program loads in less space, the 
shorter area will be output in the header. 

TASKS, value has no effect but is accepted so as to 
retain compatibility with RBM-tystem loader com- 
mand decks. 

TEMP[,value][,value2]] specifies the decimal num- 
ber of words to be allocated for the user temp 
stock (valuej) and the CP-R temp stack (value2). 
These stocks will be located in port two of the 
root. The user temp stack size defaults to 200. 
The CP-R temp stack size defaults to 200 (225 if 
the symbionrs are assembled into the system) , (Pub- 
lic Libraries do not have temp stacks. Therefore, 
this option may not be specified when a Public 
Library is being created.) The "value" parameter 
Is a decimal number. 



FILE, fid specifies the CP-R file identifier of the 
output file to which the loaded program is to be 
written (hereafter referred to as the Program File) . 
The default assignment of the program file is OV 
In the Background Temp area. If the Background 
Temp area (BT) is specified, the file name must be 
OV. When a Public Library is being created, the 
Foreground Programs area (FP) must be specified . 



program is to be output to M:LO. If no keyword 
follows MAP, a short map consisting of informa- 
tion about program allocation and overlays is 
output. If the PROGRAM keyword is given, exter- 
nal definitions and control section designations for 
each segment are listedwithout library definitions. 
For the ALL keyword, both program and library 
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definitions era listed. In default, no MAP is 
output. (Diagnostics and unsatisfied references 
are still listed on M:LL) 

If a PROGRAM or ALL mop is specified, the user 
may further use the keyword ALPHA or ADDRESS 
to request that symbol tobies be sorted alphabeti- 
cally or numerically. If neither sort is requested, 
symbols are listed in the order of encounter. 

BOUND,value sets the loading (ond execution) ori- 
gin for eoch object module to the next higher mul- 
tiple of the bound value (e. g. , if BOUND = 100, 
then on origin would chonge from 3EF to 400). The 
"value" parameter must be a hexodecimal number 
less than or equal to 1000 ond a power of 2. Sug- 
gested values ore 10, 100, or 1000. The BOUND 
does not apply to Library modules. If BOUND is 
not specified, the Loader begins each module on 
a double word boundary. 

UDCB, value specifies the number of unnamed DCBs 
to be allocated by the Looder. (See "Looder- 
Generated Items" for de toils. ) The "value" pa- 
rameter is a decimal number. 



STEP specifies o 
from paper tope 

fPRl[MARY] } 

Isec[ondary]J 



"WAIT" after boding each module 
Used in CP-R ATTEND mode. 



specifies task type, and affects 
segment definitions. Segment 
origins are forced to page boundaries for secondary- 
task segments, but not for primary-task segments. 
If not specified, SECONDARY is assumed. For 
background programs, only SECONDARY is valid. 
Either option may be specified for Public Library 
creation. 



SMM specifies the Simplified Memory Management 
option. This option provides for compatibility of 
programs designed for the memory organization of 
background in Xerox RBM (unmapped) systems, 
ond is described in detail in the chapter on CP-R 
Memory Management. (Note that certain of the 
standard CP-R processors, currently including the 
service processors, must be loaded with SMM if 
they ore loaded by the Overlay Loader.) 



Example: Form Root From GO File Modules 



r 



IOLOAD GO,(TEMP,300),(MAP,PROG),(UDCB,3) 



This example specifies that the Looder is to form the root 
from object modules located on the GO file, allocate 
300 words for the user Temp Stack, output a PROGRAM 
map, and allocate three u nn omed DCBs. 



HOOT The ROOT control command is used to specify 

the object modules from which the root segment is to 
be created. The ROOT command must precede all SEG 
inds. 



The form of the command is 



q 



! »OOT [(ENTRY ,def), (EXLOCf, REL], hexoddr; 
input \ / input v-i 

optionj/'" 'v'°P Hon n /J 



where 

ENTRY.def specifies the location at which exe- 
cution will commence after the root is loaded 
at execution time. The def parameter must be an 
external definition (1-8 EBCDIC characters), not 
necessorily in the root segment. This entry point 
overrides all subsequent entry addresses encountered 
in loading. The default entry address is the last 
transfer address encountered in the object modules 
of the root. 

EXLOC[,REL],hexaddr specifies (subject to bound- 
ing) the origin of root part two. The value hexoddr 
is a hexodecimal volue. If REL appears, hexoddr 
is treated as o word address relative to the de- 
fault FWA for the program (see option FORE for 
the OLOAD command). If REL does not appear, 
hexoddr is an absolute word address. If the EXLOC 
option is not used, the default address for root 
port two will be the first bounded address past the 
lost address used by any other segment. 

Input options are of the form 

IDEVICE,type[,PACK]j 
FILE, fid 
OPLB.Iobel U' ¥ ° ,ue ] 

NONE 



where 



DEVICE, type specifies the input device tr» the for- 
mat yyndd. 

where 

yy is a device type code. 

n is the IOP to which the device is 
connected. 

dd is the hardware device number of the 
device (e.g., CRA03,9TA81). 

PACK specifies that the input is from 7-trock mog- 
netic tape with packed binary format. 
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FILE, fid specifies tit* CP-t file identifier far on 
Input fil*. IT the Background Temp area (BT) 
It specified, the fil* nam* mutt be GO. Note 
that a file may be used as input to more than one 
segment (in different paths). A named file it re- 
wound each time it it opacified; the GO file 
it not. 

OP LB, lobe I specifies the operational label from 
which the object module (s) will be input. The 
"label" parameter must be a 2-charocter standard 
system operational label. 

value either a decimal number (1 < value S 81 91) 
that specifies the number of object modules to in- 
put from the specified device/File; or the text 
String, EOD, which means to input from the speci- 
fied device/file until on IEOD is encountered. If 
value is omitted, one object module will be input 
from the specified device/file. 

NONE indicates that no ROMS are explicitly re- 
quested. The segment will be composed of any 
areas allocated in response to :RES or :LCOMMON 
commands, and any library ROMs necessary to 
satisfy references in :1NCLUDE command and the 
ENTRY option. If only :RES areas are included, 
a "defined" segment is produced. 

If there are no input options on the ROOT control command, 
one object module will be input from the GO file. Note 
that the order of the subfields determines the order in 
which the object modules are loaded. 



Tne form or the command is 



Example: Form Root From Input File 
/^ROOT(FILE,Dl,BETA,3),(ENTRY,START) 



This exomple specifies that the root is to be formed from the 
three object modules in a file called BETA located in the 
Dl disk area. After loading, execution is to commence at 
the location defined by the extemol definition START. 



Example: Form Root From Library Modules 
X:ROOT NONE, (ENTRY,LIBROOT) 



This example specifies thot the root is to be formed from 
only the library modules necessary to satisfy the reference 
UBROOT in the ENTRY option. 



:SEG The SEG control command it used to define a 

segment's overlay linkage and to specify the object mod- 
ules from which the segment is to be created. 



tSEG (UNK,ioV.t 1 [,ONTO,ident 2 )]. 
L_[, (option^, . . . , (option^] 



UNK,ident] specifies the identification number of 
the segment being loaded. The identf must be 
specified and must be the some number used within 
the overlay program to reference the segment at 
execution time via memory -management services. 
The "identi" parameter must be a decimal number 
between 1 and 32,767. 

ONTO,ident2 specifies the identification number 
of the segment (which must have been previously 
loaded when this control command is interpreted) 
to which this segment is linked as an overlay. If 
ident2 is absent, ident] is linked onto the root. 
The "ident2" parameter must be a decimal number 
between and 32,767 (0 denotes the root). 

optionj Is either on input option (as described for the 
:ROOT command) or one of the following options. 

EXLOC[,REL],address specifies on optional execu- 
tion oddress for loading of this segment. The 
"address" param e ter is a hexadecimal value. If 
REL appears, the "address" value is interpreted as 
a word displacement relative to the default lower 
limit for the program (see OLOAD command option 
FORE/BACK). If REL is omitted, the value is 
treated as an absolute word oddress. The absolute 
address obtained in either case wi 1 1 be bounded by 
either the specified or default BOUND. If the 
EXLOC option it omitted, the segment will be 
located at the first bounded oddress following the 
segment that this segment is linked to. 

ENTRY,def specifies an entry point for the segment. 
The "def" parameter must be an external definition 
of the program; not necessarily in the segment 
itself. The value of the "def" overrides any trans- 
fer addresses encountered in loading of the seg- 
ment. The defoult entry address is the last transfer 
address encountered in loading nonlibrary ROMs. 

->" n-i ry\ *.,>:> I s - Cl\*j+ \ ( ^ *""" 

-•■ vv£_ " J 

specifies the group 

of tasks that can 

shore the segment being linked: either all tasks in 

the system (SYSTEM) or only the other tasks in the 

same job (JOB), if omitted^ rjp segment shoring 

will be allowed. 

The presence of the PRELOAD option causes the Overlay 
Loader to omit the load module image of the segment and 
set a flag which indicates that the segment mutt hove been 
previously defined when the load module is initiated. This 
can save considerable file space when a large segment is 
shared by several load modules. ../ <Ma 
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SHARE, {^ TEM )[, PRELOAD] 



■V 



Forprlmory fades, CP-Rmemory tnanagementdoes not record 
segment activity, so the SHARE option acta s omewhat dif- 
ferently. Primary task shared s egmen ts or* not considered 
in determining the program bounds, so primary programs 
may share a data area by specifying a shared segment at the 
same address. (However, no program may be loaded with 
any segment preceding Root part T . ) For primary tasks, 
there is no distinction between SYSTEM and JOB shoreo- 
biliry. PRELOAD causes omission of the load module image 
of the segment but the user, not the system, must insure that 
the segment is actually loaded. 



ACCESS, 



fNOl 

R 

RX 
I ALLJ 



X 



specifies the memory-access control 
to be assigned to the segment. If 
omitted, ALL is assumed. For 
primary-task (unmapped) segments, this option is 
accepted but will have no execution-time effect. 
The meaning of the sub-options ore 

NO - No access permitted. 

R - Readonly. 

RX - Read and execute only. 

ALL - Read, write and execute. 

FIX specifies that the segment must be assigned 
real memory such that its virtual and real addresses 
correspond 1:1. If omitted, real memory is as- 
signed wherever it is available. A segment defined 
with the FIX option must reside in a Foreground- 
Preferred partition of real memory. 

ILOAD specifies that the segment is to be acti- 
vated with the root segment when the task is ini- 
tiated. (After initial loading, the segment is 
subject to the normal memory-residence controls 
allowed by its other characteristics.) If omitted, 
the segment must be explicitly activated. This 
option is invalid for primary-task segments. 



The input options are the same os for the ROOT control 
commands. If there are no input options on the SEG con- 
trol command, a single object module from the GO file 
will be input. 

The ROOT and SEG control commands must be input in an 
order determined by the overlay structure of the program. 
The segments in the example given in Figure 13 have been 
numbered to illustrate this order. Basically, segments are 
input one path at a time, with the restriction that segments 
common to swore than one path ore input only once. 

Example 1. 

The following control commands define the overlay struc- 
ture of Figure 14. This example specifies that one object 
module for each segment will be input from the GO file. 

tROOT 
:SEG(UNK,1,ONTO,0) 





1 


2 






' • 




3 
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4 
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6 


7 
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10 


11 
14 

15 


12 






13 















Figure 14. Overlay Example 



SEG (LINK, 
SEG (LINK, 
SEG (LINK, 
SEG (LINK, 
SEG (LINK, 
SEG (UNK, 
:SEG (LINK, 
SEG (LINK, 
:SEG (LINK, 
SEG (UNK, 
:5EG (UNK, 
SEG (LINK, 
SEG (LINK, 
:SEG (LINK, 



2, ONTO, 1) 

3, ONTO, 1) 

4, ONTO, 0) 

5, ONTO, 0) 

6, ONTO, 5) 

7, ONTO, 6) 

8, ONTO, 6) 

9, ONTO, 5) 

10, ONTO, 9) 

11, ONTO, 10) 

12, ONTO, 11) 

13, ONTO, 11) 

14, ONTO, 10) 

15, ONTO, 9) 



Example 2. 

The following control command s define the overlay structure 
illustrated in Figure 15. This example speelfiesTfeat one ob- 
ject module for each segment will be input from the GO file. 

:ROOT 

tSEG(UNK,10,ONTO,0) 
$SEG(UNK,5,ONTO,10) 
:SEG (UNK, 25, ONTO, 10) 
:5EG (UNK, 103, ONTO, 0) 
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103 











Figure 15. Object Module from GO File 



BINARY OBJECT MODULES 

The Loader inputs binory object modules from mixed media 
according to the input files and devices specified on the 
ROOT, SEG and PUBLIB commands. Files may be blocked 
or unblocked. Non-disk input is written to a temporary 
disk file for Pass 2. Binary modules ore reod sequentially 
from each disk file. Each disk file, with the exception of 
GO, Is rewound each time that it is named os input on a 
control command. Therefore, multiple inputs from o file 
(other than GO) result in the file being reread from the 
beginning. 

In this example, 

:SEG (LINK,204,ONTO,0),(FILE,FP,PROG 1 ,2); 
:(FILE,BT,GO,4) 

:SEG (LINK,205,ONTO,0),(FILE,FP,PROG 1 ,5); 
:(FILE £1,00,2) 

the first access to the PROG1 file (in SEG 204) would 
result in the first two modules being loaded from the file. 
The second access (in SEG 205) would result in the first 
five modules of the file being loaded (not modules 3-7). 
The GO file is read contiguously throughout a pass, no 
matter how many accesses ore mode. In segment 204, the 
first four object modules from GO would be loaded. In 
segment 205, the next two modules (5 and 6) from GO 
would be loaded. 



Example: 

In Figure 16, assume an overlay program wTth four ROMs 
the GO file; with segments 0, 1, and 2 coded in assembl 
language, and segment 3 coded in FORTRAN. 





Seg 1 


Seg 


ROM 2 
Seg 2 


ROM 1 


ROM 3 
Seg 3 




ROM 4 



Figure 16. :LIB Command Usage 

To speed up the load process, the :UB command in the 
stock of commands given below would be used to specify 
a search of the System Library in segment 3, and the 
no-library search option would be specified on the IOLO/ 
command. 

IOLOAD (MAP,ALL),LIB 

ROOT 



SEG (UNK,1) 
SEG (LINK,2) 
SEG (LINK,3) 
LIB SYSTEM 



•LIB The LIB control command specifies the library 

search for one segment only (i.e., the segment identified 
by the preceding ROOT or SEG command). It overrides 
the library search specified by the LIB option on the 
OLOAD control command. 

The form of the command is 



r 



LIB [(USER^YSTEM)] 



where option keywords USER and SYSTEM are used to denote 
the libraries and order of search; e.g., :LIB (USER) would 
cause only the USER library to be searched for that segment. 
If neither USER nor SYSTEM is specified, library search 
(except for Public Library) is suppressed for that segment. 



INCLUDE The INCLUDE control command allows rou 

tines to be loaded from libraries when no reference to the 
routine has been mode in any module of the segment. 

The form of the command is 



r 



:INCLUDE (de^rdef def 1) 



where def; is the EBCDIC symbol of a definition contained 
in the library routine to be loaded. The symbol may be 
one to eight EBCDIC characters. The def; must be avai I- 
able in o library specified in a preceding :UB command or 
the LIB option on the IOLOAD command; any unfound def 
results in an error diagnostic. INCLUDE also cancels a 
prior EXCLUDE for a given symbol. 
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Example: Load Two Routines From Library 



r 



sINCLUOE (?SETUP,7SET) 



In this example, Hw routines 9SETUP and 7SET are to be 
included in the load from a library previously pacified in 
the search criteria. 



SCOMfON The COMMON control command specifies 

that the Loader is to set the base of Blank COMMON at 
the end of the segment identified by the preceding ROOT 
or SEG control command, or at a location indicated in the 
rCOMMON control command. It also allows specif coti- 
of the size of blank COMMON. If this control common* 
Is not included, Wank COMMON is set at the end of the 
longest path. Only on* COMMON control command may 
be used in a control command stock. 



:EXCLU0E The EXCLUDE control command inhibits li- 

brary search and linkage for the named definition(s) even 
though on externa! reference occurs in o module of the 
segment. 

The form of the command is 



,,def ) 



-] ! 



/:EXCLUDE (def, Haefj, . 

where def; is the EBCDIC symbol of an external reference 
contained in a module of the segment. However, def; must 
not occur as an external definition in a lower level seg- 
ment of the path. The symbol may be one to eight EBCDIC 
characters. Note that EXCLUDE also inhibits linkage with 
the specified Public Library for the given symbols. 



The form of the command is 



r 



COMMON [(option. ), . . . , (option )] 



where option, is one of the following: 

EXLOC,hexloc specifies the base of Blank COMMON 
to be the address "hexloc", which is a hexadecimal 
number. If the option is omitted, the base of 
Blank COMMON will be set of the end of the 
segment (or root) defined by the previous SEG 
(or ROOT) command. 



Example: Exclude Search for Named Routine 

In this example, the tree structure illustrated in Figure 17 
shows a routine called SIN in segment 1 that has the some 
name as a library routine, and is referenced in on earlier 
segment (Seg 0). The command 



( 



:EXCLUDE (SIN) 



inhibits library search and linkage for the named routine 
only so that the TAN routine would be included in the root 
but the SIN routine would not. 





Segl 


SegO 


DEF SIN 
Seg 2 


DEF A 

REF TAN,SIN 




REF TAN 



SIZE,hexwords specifies the word size of Blank 
COMMON to be "hexwords", which is a hexa- 
decimal number. This size will override any 
size declared in a loter ROM, and any smaller 
size in an earlier ROM, but will be ignored it 
a larger Blank COMMON size has already been 
declared. If the option is omitted, Blank COM- 
MON size is set to the largest size declared 
in a previously loaded ROM. Whether the size 
is set by the option or by an earlier declara- 
tion, if a later declaration requires a larger 
size, a warning Is issued and the larger size 
is not allocated. 



™«.i%r} 



Figure 17. tEXCLUDE Command Usage 



specifies the range of sharea- 
bility of the Blank COMMON 
segment, as described for the :SEG command, 
for both primary and secondary load modules. 
PRELOAD is not allowed however, since Blank 
COMMON is never included in a load module 
image. 

FIX specifies 1 :1 virrual-to-real address correspon- 
dence for the segment, as described ^or the :SEG 
command. 



JRES The RES control command allows the user to re- 
serve and name one or more areas at the end of the segment 
for load-time or run-time debug purposes (see "MODIFY" 
control command for further comment). The areas are de- 
fined as DSECTs and may be referenced by ROMs. 
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¥iw fofm of itM commons is 



r 



RES (rfef ,size) j r,(def,stze) 2 , . . . ^deffSize)! 



def creotes an external definition whose value it 
the FWA of the reserve area. The definition must 
be unique within the path. 

size is a decimal value specifying the number of 
words in the reserve area. 

Example: Reserve Two Areas at Segment End for Debug 
Purposes 



r 



RES (PATCH1,5),(PATCH2,10) 



In this example, two areas are being reserved at the end 
of a given segment; the first (PATCH1) comprising an 
orea of five words and the second (PATCH2) an area of 
ten words. 



:LC0UM0N The LCOMMON control command ollows 

the user to determine the allocation of Labeled COMMON 
blocks (DSECTs) within the root and overlay segments of the 
program. (See "FORTRAN Interfoce-Labeled COMMON" 
for a discussion of restrictions concerning Labeled COMMON 
allocation and initialization. ) 



ft is the user's responsibility to insure that the 
following rules are observed: 

• The block may be deferred only once 
before it is declared in a ROM being 
loaded. 



The block must be allocated by one of 
the methods described, or an unsatisfied- 
reference error will result. 

If the block is deferred in a segment 
common to several paths which declare 
it in ROMs, it must be ol located in a 
segment which is common to those paths. 
Otherwise, it will remain unallocated in 
some paths, and will result in unsatisfied - 
reference errors in those paths. 
i 

K the content of the block is initialized 
by assembled code, that code must be in 
the segment where the block is allocated. 



Examples: Specify Allocation of a Labeled COMMON 
Block 



In the overlay structure given in Figure 18, seg references 
a Labeled COMMON block A of 50 words; seg 1 references 
a Labeled COMMON block A of 100 words; seg 2 references 
o Labeled COMMON block A of 60 words. 



The form of the command is 



/:LCOMMON (dsect n )[,(dsect 1 ),...,(dsect )] 
vi n 



where 

dsectj is either blockname,size or blocknome, DEFER. 

blocknome is the one- to eight-character EBCDIC 
name of the Labeled COMMON block or DSECT. 

•ize Is o decimal value specifying the largest word 
size needed for the allocated block. If 'size' is 
omitted, zero is used. 

DEFER specifies that the Labeled COMMON block 
will not be allocated until it is mentioned again 
in either on :LCOMMON commond without DEFER 
or a :RES command. The size allocated will be 
the largest specified in either that command or 
any declarations encountered in ROMs by that 
time. K a Labeled COMMON block is deferred, 





Segl 


Seg 


References a Labeled 
COMMON block A 
of 1 00 words 

Seg 2 


References a 
Labeled COMMON 
block A of 50 words 




References a Labeled 1 
COMMON block A 1 
of 60 words _ J 



Figure 18. DSECT Allocation Example 



Normally, the Loader would allocate block A with the size 
first encountered (50 words), and would output a diagnostic 
alarm when the second block of 100 words in seg 1 is 
encountered. 
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However, the :LCOMMON command inserted in tho dock 
structure 

IOLOA0 <MAP,AU) 

:ROOT (DEV,CRA03) 

tLCOM (A, 100) 

:SEG <LINK,1),(DEV,CRA03) 

:SEG <UNK,2),(DEV,CRA03) 



l| specifies the word to bo inserted (right- 
justified) ot tho ith location. Tho word con be 
expressed as: 

1. A signed (plus *lgn (+) optional) hexadecimal 
or decimal value that cannot be enclosed in 
parentheses. Hexodeciital values are pre- 
coded by a period. 

Examples 

-c, 100, .2A, -.AF 



would let the size of block A to 100 words. 



{MODIFY The MODIFY control command modifies core 

locations of relocatable programs at load time. Core lo- 
cations in either root or overlay segments con be modified. 
Since the reserved area at the end of a segment (allocated 
with the RES command) is output to disk as part of the 
segment, that area can be used for "patches" that will' be 
read in with the segment at execution time. The MODIFY 
commands must be input at the end of the ROOT, SEG, or 
PUBUB substack for the segment being modified. If the GO 
option is specified, the MODIFY commands must follow any 
RES or INCLUDE commands and precede any -.ASSIGN 
commands. If the (GO, LINKS) option is specified, the 
MODIFY commands must be ordered by segment number 
and follow the OLOAD command. 

Normally, the image of a segment in a load module does 
not include :RES areas, since these areas need not be ini- 
tialized. If o -.MODIFY command affects such an area 
however, the load module image of the segment is extended 
to include the last modified word. 



The form of the command is 

A 



MODIFY[(SEG,ident),](LOC,address),word 1 [,. . -,wordJ 



where 



SEG,ident specifies the identification numbet of 
the segment to be modified. This option is only 
necessary when the (GO, LINKS) option has been 
specified. If this option is omitted, the segment 
identified by the preceding ROOT, SEG, or 
PUBLIB command will be modified. 



LOC,address specifies the relative location of the 
first 32-bit word to be modified. The address must 
be expressed as on external definition name plus 
or minus on optional hexadecimal or decimal off- 
set. Hexadecimal values ore distinguished from 
decimal values by a period preceding the hexadec- 
imal value (i.e., .A9B). 



3. 



Examples: 



An extemol name plus or minus an optional 
offset that cannot be enclosed in parentheses. 
The offset can be either a hexodecimol or 
decimal value. Address resolution for the ex- 
temol con be specified by using the SYMBOL 
notation: rr(name) ± offset 

where 

rr = BA, HA, WA, or DA 

Word resolution is assumed by default. Note 
that BA(ALPHA) + 3 is legal; BA(ALPHA + 3) is 
not. If the name specified has not been de- 
clared on external Somewhere in the overlay 
segment's path, it will be listed as an unsat- 
isfied REF on the MAP. 



Examples: 

TABL + .F, TABL-1, TABL, HAfTABL) 



A symbolic instruction that must be enclosed 
by parentheses. The mnemonic field of the in- 
struction must be an EBCDIC operation code 
that immediately follows the left parenthe- 
sis. (The floating-arithmetic, floating-shift, 
decimal, end byte string instructions have not 
been implemented.) The register and index 
fields can only be signed hexadecimal or 
decimal values. The address field can be 
either a signed hexadecimal value, a signed 
decimal value, or on extemol name plus or 
minus an optional offset. 



(' 



-.MODIFY (LOC,MAP + . F0),(B PATCH +6^ 



tMODIFY (LOC,PATCH +6),(U,6 BA(TABL)), 
1 (LW,9 *WA(VAL) + 9,6),(B MAP + . Fl) 
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r 



tMODIFY (SEG,0),(LOC,U.-PCB+. 140),. 3F,~.F, 250,-1 



MODIFY (SEG, l),(LOC,CCl + . 80),(LI,5 0), j 

' (BAL, 15 5ERCHTAB),(MTW,-1 FLCHG), 1 



■ — (BLEZ*CC1 + 5),(LB,6 0,5), ■ 



-(STB,6 •WACTABD + 1,5),(LW,0 .4E) 



Example: Assign a DCB at Load Tima 



( 



ASSIGN (F:2,LPA02),VFC,(RECL,r33) 



In this example, the DCB F:2 is assigned to the line printer. 
Vertical format control Is specified, so that the first byte in 
each record controls the spacing on the line printer. Al- 
though 133 bytes are output for each record, only the last 
132 bytes are printed because VFC is specified. 



tMODIFY (SEG,3),(LOC,FPTLO),M:LO + .11000000,— i 

rz 



.F0400090,ERMO,ABNIO,BUF1,80,0 



In reporting MODIFY command errors, any EBCDIC string, 
decimal number, or hexadecimal number that is separated 
by a comma, blank, plus sign, or minus sign (ignoring pa- 
rentheses) is counted as an item. An example of items on 
a MODIFY command is given in Figure 19. 



: ASSIGN The ASSIGN control command is used to 

create, initialize, or modify DCBj at load time. If the DCB 
is in the program's DCBTAB table, it will be either initial- 
ized or modified. If the DCB is not named in DCBTAB, the 
Loader will build the DCB from the parameters on the 
:ASSIGN control command in an unnamed DCB's entry. An 
error diagnostic is output if an unnamed DCB entry is not 
available (see "Load Time ASSIGN"). 

The format and options arc identical to the Monitor (ASSIGN 
control command. The : AS SIGN control commands must be 
the last commonds in the control command stack. 



:PUBLIB The PUBLIB control command is used to specify 

the object modules from which the Public Library is to be 
created. The order of the parameters determines the order 
of loading. 

The form of the command is 



=*» ub [(XMX) (X)] 



where the input options are the some as for :ROOT. 

If there are no input options on the PUBLIB control command, 
the first object module on the GO file will be input. 

When the specified object modules have been input, the 
Loader searches the libraries (specified on the OLOAD con- 
trol command or the System Library by default) to satisfy 
any unsatisfied primary references. If a COMMON, labeled 
COMMON block, or other DSECT is encountered in an object 
module of the Public Library, the load process is aborted and 
on error diagnostic is output. If the severity level exceeds 
zero in the load process, the Public Library is not loaded. 
If anything was written on the Public Library file, the file 
is destroyed and an error diagnostic is output. 



tMODIFY (SEG,2),(LOC,CCI+.F),(LW,6 *FWATAB-l,e),(Ll,l BA(TABL) + .F),.FF 

- I t t 



item 3 



item 2 



i ton 5 



tern 7 



itfeffi t item 

ii 



item 8 



item I 



item 4 .item 6 



13 
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15 
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Figure 19. tMODIFY Command Items Example 
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The following conventions concerning other control commands 
should be observed when using the PUBLIB command: 

1. The FORE option must be specified on IOLOA0 to de- 
fine the area that the Public Library is to occupy at 
execution time. If the limits of this area ore exceeded, 
the Loader aborts. 

2. The FILE option on I O LOAD must either specify the 
name of the Public Library file being created in the 
Foreground area or omit the areo name so that it de- 
faults to FP. 

3. The TEMP, PUBLIB, GO, and TASKS options are 
illegal, and if used, the Loader will abort with on 
OLOAD control command error. 

4. BOUND should be avoided unless o special debug ver- 
sion of a Public Library is being created. 

5. .-ROOT, : ASSIGN, :LCOMMON, and :COMMON 
control commands cannot be used in creating a Public 
Library. The :RES command eonnot be used in the 
PUBLIB command substack, but may occur in o SEG 
substack of o Public Library load deck. 

6. A single :SEG command substack may follow o :PUBLIB 
command substack. This is intended primarily for de- 
fining a context data area to be used by reentrant Pub- 
lic Libraries. The segment so defined will be acquired 
in separate reol memory for each secondary task re- 
quiring the Public Library. It will not be subject to 
memory management calls. The only parameter groups 
permitted for this :SEG command will be "EXLOC" and 
"input option" as described for the :SEG command, 
earlier. (Note that the LINK parameter group, re- 
quired for other :SEG commands, is not allowed for a 
Public Library context :SEG command. ) The substack 
for this command may contain only :RES, tMODIFY, 
:UB, and INCLUDE commands. 

Example: Create Public Library From Specified Module 



• 



:PUBUB (FILE,SP,MODULE,10) 



In this example, the Public Library will be created from the 
first ten ROMs of the System Library. The Public Library 
will Include a segment of 100 (decimal) words at loca- 
tion 9000 (hexadecimal). 

ILMHOR This command allows the user to specify values 

for certain task control parameters when the load module for 
the task ts linked. These parameters do not affect the link- 
ing operation in any way; they ore mainly saved in the load 
module header for reference by the task initiation service. 
The command or any of its options may be omitted, in which 
case CP-R task initiation will provide values for the param- 
eters not specified. For most uses, the default values pro- 
vided are appropriate, so the command may be omitted. 
When it is used, the :LMHDR command must appear past all 
commands other than ASSIGN commands. It may not appear 
during linking of a PUBLIB. 

The options which may appear on a :LMHDR command are 
described below. 



(■ 



:LMHDR optionf, option, . . ., option] 



In this example, the Public Library will be created from the 
first 10 object modules in the System Library. 



where option is one of the following: 

(SECB,m) This option specifies that the task will be 
allowed no more than m asynchronous service calls. 
If the option is omitted, the system default value 
pertains. 

(RECB,m) This option specifies that the task will be 
allowed to service no more than m signals or other 
events. If the option is omitted, the system default 
value pertains. 

(ENQ,m) This option specifies that the task will be 
allowed no more than m simultaneous enqueues for 
resource availability. K the option is omitted, the 
system default value pertains. 



PROGRAM RLE 

The Program File contains the root and overlay segments in 
core imoge format and a one-granule header. The program 
header is located at granule and contains information nec- 
essary to run-load the program. 



Example: Create a Public Library with o Context Segment 



(' 



t 



t 



RES (CONTEXT,100) 



SEG NONE,(EXLOC,9000) 



PUBLIB (FILE,SP,MODULE,10) 



■O0T SEGMENTS 

The root is divided into two parts (see "Core Layout at 
Execution Time" later in this chapter). Portfone of the 
root always beings in granule 1 of the Program File, 
and contains the PCB, root code, library code, labeled 
COMMON, and RES areo for the root. Part two contains 
the DCBTAB, OVLOAD Table, Loader-created DCBs, and 
the Temp Stacks. 

The Temp Stocks are not output on the Program File. Each 
port of the root is written as o continuous string of bytes. 
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•VEMATtEfaKITS 

ioch *vwloy segment begins en a granule boundary and it 
written en the Program File as a continuous string of bytes. 
The order of segments on the file b unimportant, sine* the 
granule displacement pointer (in the OVLOAD table) for 
each segment specifically determines its position. Load 
module images of segments cannot be longer than I6K words 
(64K bytes); however, since RES areas ore omitted from the 
load module, :RES commands may extend the size of a 
segment beyond 16K words. 



TEMPORARY OSK FILES 



The user can create his own DCBs within the source code 
and locate them in any segment of his overlay program. 
However, K the user wishes to change parameters in a DCB 
at execution time via an (ASSIGN commend, he must de- 
clare the DCB as an externa! definition (with a name that 
begins with an F:) and locate the DCB in the root segment. 
To utilize the FORTRAN capability of performing I/O 
by using variables as operational labels, the user can 
specify (on the OLOAD control command) a number of un- 
named DCBs to be allocated by the Loader. The user must 
name and define these DCBs before the program executes; 
either at load time (with ASSIGN), or execution time 
(with (ASSIGN). 



The Loader uses six scratch files in the Background Temp 
area of the disk (XI, X2, . ..,X6). If one of these files 
overflows, the Loader completes the pass over the object 
modules even though the load will be aborted. The Loader 
calculates the number of records (for sequential files) or 
granules (for direct-access files) required for all scratch 
files and lists this information on the Map. With this in- 
formation, the user can then allocate the Background Temp 
files with an IALLOBT command and reload the program. 



BCBTAB 

The DCBTAB table is created by the Loader, and contains 
the EBCDIC name (if on/) arid location of each Loader- 
recognized or created DCB in the rqot of the overlay 
program. The EBCDIC name of an -unnamed DCB is inserted 
when the DCB Is given a name by either the I ASSIGN or 
ASSIGN control command. 



UNDER-GENERATED ITEMS 



OVLOAO TABLE 



All items discussed in the following paragraphs are gener- 
ated by the Loader and located in the root segment of the 
overlay program (see Figure 22 in this chapter for o diagram 
of the core allocation). 



The OVLOAD table is built by the Loader and contains the 
information necessary for memory-management functions to 
access overlay segments at execution time. The OVLOAD 
table consists of one entry for each overlay segment, with 
a total of eleven words per entry. 



PROGRAM CONTROL BLOCK 

The PCB is built by the Looder and located at the FWA of 
the overlay program area. 



RATA CONTROL BLOCK 

The Loader automatically includes a copy of the M:SL DCB 
in any program that has overlay segments. (M:SL is used by 
the memory management functions to read in overloy seg- 
ments at execution time. ) 



TEMP HACKS 

The Looder aflocotes space for the overlay program's user 
and CP-R Tamp Stacks either according to the number of 
words specified on the OLOAD control command, or by 
default. The Temp Stocks are located at the end of part 
two of the root segment and are not output on the Program 
File (see "Core Layout of User Program at Execution" later 
tn this chapter). 



Any external DEF/REF that begins with an M: or F: is de- 
fined to be either a system (M:) DCB or user (F:) DCB. DCBs 
referenced by the program that are net satisfied at the con- 
clusion of the load process are either created or allocated 
by the Loader. Copies of system and FORTRAN DCBs ore 
created with their standard system parameters and opera- 
tional label assignments. Space for user DCBs is allocated 
at the rate of seven words per DCB. 
•*- 

Parameters for user or system DCBs may be defined by either 
1ASSIGN control commands at execution time (for back- 
ground p rog r am s only) or ASSIGN control commands at 
load time. 



EXTERNAL DEFINITIONS 

The Looder adds the external DEFs F4-.COM, U:PCB, and 
P:END to all programs except for Public Libraries. F4:COM 
is the name of FORTRAN'S blank COMMON. The initial 
size is set to zero and changed to the largest size encoun- 
tered during the load process. If therefore no references 
to F4.COM, blank COMMON is olf^oted with o size 
of zero. The Looder indicates the LWA + 1 (including 
blank COMMON) of the loaded overloy program by on 
external definition, P:END. External references to P:END 
within the overlay p rogram will be linked to this defini- 
tion. The external definition U:PCB has as its value the 
FWA of the PCB. 



Temporary Disk Files/Loader-Generoted Items 



151 



The external DEF FP:MBOX ft added to primary foreground 
overlay programs by the Loader only if an area was allocated 
at SYSGEN time. ffiMBOX it the name of the primary 
program 't mailbox. External references to FP:MBOX will 
be linked to this deTmition. Secondary tasks cannot use -the 
mailbox for intertask communication. 



UBRARIES 

The Overlay loader supplies the capability to search the 
System Library or the User Library in any order. The default 
condition is for the Loader to search and load only from the 
System Library. Control commands and keywords enable the 
user to control more specifically the search and load options. 
Note that an attempt will first be made to satisfy all REFs 
with DEFs from the Public Library, if a Public Library has 
been specified on the OLOAD control command. 

If any unsatisfied primary references exist after loading the 
specified modules for a root or an overlay segment, the 
Loader searches the library or libraries in the specified order 
to satisfy those references. Thus, if an external REF is mode 
to a higher level segment, the name should not be the seme 
as a library definition. Consider the following: 





1 


2 






- 


4 


3 












If segment 1 contains a primary reference, 9SIN, it will 
normally be satisfied by loading a Library at the completion 
of segment 1. Thus, If the definition 9S1N occurred in seg- 
ment 2, it would be in error (a duplicate definition). The 
loading of 9S1N from the library can be suppressed by using 
the EXCLUDE command. In this case, the forward REF would 
be linked and no duplicate DEF would occur. However, if 
the definition 9SIN occurred in the root, or in the library 
loaded in the root, no search for 9SIN would be made in 
segment 1, and the occurrence of the definition 9S1N in seg- 
ment 2 would be in error. fVimary references can occur in 
two ways: As external references in a module, or by listing 
the primary references on the INCLUDE control command. 



SYSTEM AMD USER LIBRARY UBMRIES 

Cross-references between System and User Libraries are el- 
lowed. However, since each library is searched only once 
per segment, the order of search is important. 

If Library A contains references to be resolved by Library B, 
the search criteria :LIB (A, B) must be specified to guarantee 
cross-reference resolution. If B also contained references 



to A they would not be resolved. (Note that these remarks 
do not apply to cross-references within any tingle library). 

Generally, the System Library should contain the FORTRAN 
Math and Run-Time Routines and should be independent. 
The User Library is a repository for user subroutines ond al- 
ternate Math and Run-Time routines that supersede the same 
routines in the System Library. 

The typical search order would be 

:LIB (USER,SYSTEM) 



where both libraries are referenced. In this case, all un- 
satisfied REFs from the User Library would be satisfied 
(where possible) from the System Library. 



ASSEMBLY LANGUAGE 

Library routines may be coded in AP or FORTRAN IV. 

ENTRY ADDRESS 

Entry addresses in library routines are ignored. 

SYSTEM AND USER UBRARIES ON DISK 

The System Library and the User Library on disk are struc- 
turally identical. Each library consists of four files: 

EBCDIC 

MOD1R 

DEFREF 

MODULE 

The System Library is located in the System Programs (SP) 
area. The User Library is located in the Foreground Pro- 
grams (FP) area. 

Only the MODULE file contains the actual binary modules 
of the library. The other files are tables constructed by 
the RADEDIT to facilitate the rapid search of the library 
by the Overlay Loader without actually reading the module. 
The library is structured on the principle that access should 
be as fast as possible, since it it performed frequently dur- 
ing an overlay loading procedure. * 

The three Hies: EBCDIC, MODIR, and DEFREF contain 
enough information to determine which modules from the 
actual MODULE File are to be loaded without examining 
these modules directly. All four library files are constructed 
ond maintained by the RADEDIT. These short files contain 
coded information about the external definitions and primary 
references for each module in the library. 
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To begin construction of a library, the user ollocotes the 
EBCDIC, DEFREF, MODIR, ond MODULE film with the 
RADEDIT, and then copies the library's binary object mod- 
ules onto the MODULE file. As eoeh module is copied, 
the DEFs and REFs are scanned, and corresponding entries 
are built in the other files by the RADEDIT. Library rou- 
tines may be added or deleted by using the RADEDIT .COPY 
and :DELETE commands. 



A Public Library is created by using the :PUBLIB control 
command in place of the ROOT command, and modules may 
be input and libraries searched and loaded in the same man- 
ner as for standard loading. Because each Public Library 
has a unique name, more than one Public Library can exist in 
the system. Although no more than four Public Libraries can 
be cal led by any one progr a m, any number can be created. 



PUBLIC LIBRARIES 

The Public Library is a file containing a set of reentrant 
subroutines in core image format that can be shared in com- 
mon by all secondary or all primary programs. The resultant 
saving in core can be considerable where library routines 
are shared. The Public Library is created from input modules 
or library routines by the Loader (see "Forming a Public 
Library"). The availability of the Public Library is deter- 
mined at execution time. 



CALLING THE PUBLIC LIBRARIES 

When a user indicates by the PUBLIB keyword on the OLOAD 
control command that Public Libraries are to be used to sat- 
isfy references, the names are set in the program header for 
the Root Loader, and the Public Library Symbol tables are 
read from the ftiblic Library files and added to the loaded 
program's Symbol table. The Loader will satisfy primary 
external references with Public Library definitions at the time 
the external reference is encountered in the object module, 
not at the and of the segment (as when the other libraries 
are searched). When the program is initiated, the header 
is searched to determine if the program contains the name of 
one or more Public Libraries. If so, and one of the named 
Public Libraries is not already in core, the Monitor deter- 
mines whether Public Library space is available. If avail- 
able, the Root Looder reads in the nomed Public Library or 
Libraries and the program executes. If the space is not' 
available for all Public Libraries referenced, the program 
will be neither root loaded nor executed. 

Each Public Library file is designated at Public Library cre- 
ation time (see "Forming a Public Library"). All Public Li- 
braries are located in the Foreground Programs area of the 
disk. Public libraries must be either primary or secondary; 
they may not be both. 



UBRARY PROTECTION 

Secondary Public Library root segments are given read-and- 
execute protection, as they are shared. Context segments are 
writable, since they are differently mapped for each task. 



RELEASING A PUBLIC LIBRARY 

If no currently executing program is utilizing a fablic Li- 
brary it is released. 



ROUTINES USED TO FORM A PUBLIC UBRARY 

All routines used to form a Public Library must be reentrant. 

If the Public Library is primary, the user Temp Stack may 
be used directly for context, or the method of moving local 
storage in routines to the user Temp Stack on reentronce 
can be employed (e.g., Real-Time FORTRAN subroutines 
and FORTRAN Run-Time Library). FORTRAN main routines 
are not reentrant and cannot be used. 

Secondary Public Libraries should use a context segment 
to achieve reentroncy. 

Routines assembled in AP are acceptable provided the 
reentroncy requirements are met. 

No references to COMMON, labeled COMMON, or 
DSECTs are allowed in any Public Library routine. 

Since DCBs in the Public Library could not be assigned and 
might not be reentrant, DCBs will not be allowed in any 
Public Library routine. Note that it is not possible for the 
Looder to warn the user about DCBs that are not named 
according to the conventions ond mode externals. 

The file associated with each Public Library is in the FP 
area. This file contains the actual core image of the Pub- 
lic Library and the corresponding Symbol table used by the 
Looder. The name of the file must corr es pond to the name 
given with the FILE keyword on the OLOAD control com- 
mand, ond the file must be previously allocated in the FP 
area by the user. If loading of the requested modules and 
libraries has been completed and there are no remoining 
unsatisfied primary references, the Loader writes the core 
image and the Symbol table to the file in the FP area. If 
unsatisfied primary references are found, the file in the FP 
area is destroyed. A file name of a previous Public Library 
may be used, but at the risk of obliterating the old file if 
the new one cannot be completed. 



MAP 

Three types of maps may be output to M:LO following Pass 2 
according to the MAP keyword on the I OLOAD control 
command: a short map, PROGRAM map, or ALL map. If 
the MAP option is not specified, none is output. 

The short map Is output when the MAP keyword appears 
alone. It consists of essential information about the over- 
lay structure. 
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The PROGRAM Mop consists of all elements of Mm short 
Map, plus all external definitions and control sections con- 
tained in the input modules (excluding those from Library 
ROMs). 

The ALL Mop consists of oil elements of the PROGRAM 
map and includes oil definitions and control sections 
from Library ROMs. A typical PROGRAM mop is illus- 
trated in Figure 20. 

In Figure 20, the heoder keywords have the following 
meaning: 

1. Program Heoder Keywords: 

RLE: Area and name of the program file. 

NUMBER OF SEGMENTS: Decimal number of each 
type of segment. 

LIMITS: FWA and LWA of the Program area. 

BOUND: Hexadecimal value on which object module 
addresses are bounded. 

BLANK COMMON BASE: FWA of blank COMMON 
with the SIZE specified in decimal words. 

PUBLIC LIBRARIES: Names of the Public Libraries, if 
any, referenced by the program. 

TOTAL MEMORY SIZE: Sum of the memory sizes in 
words of all segments of the program (includes 
Root and COMMON segments; excludes Public 
Libraries), in hexadecimal/decimal. This would 
be the memory required by the program if it were 
not overlaid. 

TOTAL FILE SIZE: The hexadecimal/decimal number 
of granules used in the load module file. 

LIBRARY SIZE: Total number of words loaded from the 
user and/or system libraries. 

PROGRAM ERROR SEVERITY: Set to one if any kind 
of error is encountered; otherwise, set to zero. 



SIZE (second o ccu rrence): Size in words of the CP-R 
Tamp Stack. 

DCBTAB: FWA of the DCBTAB. 



3. Segment Heoder Keyword: 

INPUT: Total number of hexadecimal words in the seg- 
ment boded from the ROMs, RES, and LCOMMON 
control commands. 

LIBRARY: Total number of hexadecimal words in the 
segment loaded from User and/or System Libraries. 

MEM WL: Total hexadecimal length in words occupied 
by the segment in memory. 

LM BL: Total hexadecimal length in bytes of the seg- 
ment image in the load module file. 

FWA: First word address of the segment. 

LWA: Lost word address of the segment. 

ENTRY: Entry address of the segment. 

ROMERR: Set to one if the error severity level is set 
on any ROM input for the segment; otherwise, it 
is set to zero. 

LDERR: Set to one if any loading errors are encoun- 
tered for the segment; otherwise, it is set to zero. 

GRAN: The granule number (decimal) on the program 
file where the segment's core image beings. 

4. Control Sections: 

Control sections input from the program ROMs ore listed 
with the following information: 

*»... »«.»« i_ address size 
ROM ROM number ^^ ^ } 



2. Loader-Supplied Structure Keywords: (All values are 
hexadecimal.) 

OVLOAD: FWA of the OVLOAD table. 

PCB: FWA of the Program Control Block (PCB). 

ENTRY: Entry word address for the root. 

UTSFWA: FWA of the User Temp Stock. 

SIZE (first occurrence): Size in words of the User Temp 
Stack. 

RTSFWA: FWA of the CP-R Temp Stack. 



Control sections input from user and/or system libraries 
are listed with the following information: 

{ULIBI Record displacement address size 
SUBl in the MODULE file (hex.) (dec.) 



5. DCBs 



The user and system DCBs are listed after the control 
section of the ROOT with the following information: 

{SDCBl J name ) address 

UDCbJ I UNNAMED! (hex.) 
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IOLOAD (HAP,nO,ALP),(FOR,6000.7000),(LU.SYS),(USCB,5),PRI 

HOOT (FIL.BT.G0.4) 

:SEC (LIN.l),(FIL,BT,CO,3) 

:RES (ABC ,400) 

rASSIGN (F:50,LO) 

: ASSIGN (F:51,L0) 

:ASSIGN (F.-52.LO) 

PROGRAM MAP 
FOREGROUND PROGRAM 

FILE BT.OV 

NUMBER OF SEGMENTS: 



LIMITS : FVA : 6000 
BOUND 2 
BLANK COMMON BASE 
PUBLIC LIBRARIES 
TOTAL MEMORY SIZE: 
TOTAL FILE SIZE: 
LIBRARY SIZE 4A9/ 
PROGRAM ERROR SEVERITY 1 

OVLOAD PCB ENTRY UTSFWA SIZE RTSFWA SIZE DCBTAB 
674E 6000 600E 67D8 64 683C C8 67BA 

ROOT PART ONE 

INPUT LIBRARY MEM WL LM BL FWA LWA ENTRY ROMERR LDERR GRAN 
35 405 43A 10E4 6000 6439 600E 1 1 



2 


ROOT 


1 


COMMON 


1 


OVERLAY 





PUBLIC LIBRARY 


LWA: 


6903 


6686 


SIZE 200 


NONE 




904/ 


2308 WORDS 


8/ 


6 GRANULES 


1193 


WORDS 



CONTROL SECTIONS 



ROM 




1 


600E 


20 




ROM 




2 


6022 


4 




ROM 




2 


6026 


2 




ROM 




3 


6028 


4 




ROM 




3 


602C 


2 




ROM 




4 


602E 


4 




ROM 




4 


6032 


2 




SDCB 




F-.108 




677B 




SDCB 




M:DO 




6782 




SDCB 




M:0C 




6789 




SDCB 




M:SL 




6790 




SDCB 




F:50 




6797 




SDCB 




F:51 




679E 




SDCB 




F:52 




67A5 




SDCB 




UNNAMED 


67AC 




SDCB 




UNNAMED 


67B3 




DEF 


IM 


A 




6022 





DEF 


IM 


B 




6028 





DEF 


IM 


C 




602E 





U REF 


IM 


D 








DSCT 


IM 


F4 :COM 


6686 





DEF 


IM 


P:END 




6904 





DEF 


IM 


U:PCB 




6000 





DEF 


IM 


V#A 




6026 





DEF 


IM 


V#B 




602C 






200 



Figure 20. Typieof PROGRAM Mop 
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DEF IH 


v#c 


6032 





DEF IM 


AMAIN 


600E 





ROOT PART TWO 









INPUT LIBRARY MEM UL IX U 
1B6 1B6 228 

CONTROL SECTIONS 

SEGMENT 1 LINKED TO 

INPUT LIBRARY MEM WL LM BL 
1A8 A4 24C 2T0 

CONTROL SECTIONS 



PWA LWA ENTRY ROMERR IDERR GRAN 
674E 6903 7 



ROM 




1 




643A 


ROM 




1 




643E 


ROM 




2 




6440 


ROM 




2 




6448 


ROM 




3 




644C 


ROM 




3 




6450 


DSCT 


IM 




ABC 




DEF 


IM 




OA 




DEF 


IM 




OB 




DEF 


IM 




OC 




DEF 


DJ 




V#OA 




DEF 


IM 




V#OB 




DEF 


IM 




V#OC 




BLANK COMMON 









FWA 


LMA 


643A 


6685 


4 




2 




8 




4 




4 




2 




64F6 





643A 





6440 





644C 





643E 





6448 





6450 






ENTRY ROMERR LDERR GRAN 
6 



400 



INPUT LIBRARY MEM WL LM BL 



C8 



C8 



TWA LWA ENTRY ROMERR LDERR GRAN 
6686 674D 7 



CONTROL SECTIONS 








LOADING 


WAS COMPLETED 








FILE 


BT.OV 


USED 


8 


GRANULES 


FILE 


BT.X1 


USED 





GRANULES 


FILE 


BT.X2 


USED 


2 


GRANULES 


FILE 


BT.X3 


USED 


2 


GRANULES 


FILE 


BT.X4 


USED 


2 


GRANULES 


FILE 


BT.X5 


USED 


2 


GRANULES 


FILE 


BT.X6 


USED 





GRANULES 



WARNING: UNSATISFIED REF'S 

END OF MAP 
!FIN 



Figurt 20. Typieol PROGRAM Mop (cent. ) 
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DCFs, REFs, ond DSECTi 

The externals are listed with the following Inforantion: 



»'U 



• unsatisfied, undefined, or 
unallocated 

* doubly defined or referenced 



b a constant, It it expressed as a hexadecimal 
number followed by the letter 'C. For undefined 
symbols, the address field is blank. 



f. The DSECT size In words (decimal). 



b. 



DSCT 


m 


dummy section 


DEF 


s 


definition 


REF 


c 


primary reference 


SREF 


B 


secondary reference 


PL 


c 


Public Library 


UL 


= 


User Library 


SL 


= 


System Library 


IM 


= 


input Module 



d. The symbol name in EBCDIC (one to 63 
characters). 



e. If the definition is an address, it is expressed as a 
word oddress and a byte offset. If the definition 



ERROR DIAGNOSTICS 

The Overlay Loader outputs diagnostic messages to M:OC 
and M;LL. Duplication is suppressed if OC and LL ore 
assigned to the same device. 

K an operator response is required, the Loader will call the 
"WAIT" function. The operator should hit the console 
interrupt and key in one of the following: 



X 
COC 



Continue. 



Abort. 



Read the corrected c ommand from M:OC 
ond continue (used only in response to con- 
trol command errors). 



Note that the "WATT" routine aborts if on (ATTEND 
control command has not been encountered in the job stock. 
The diagnostic messages in Table 19 are output by the 
Overlay Loader. 



Table 19. Overlay Loader Diagnostics 



Text 


Meaning 


Action 


BACKGROUND TOO SMALL 


User's program cannot be loaded 
in the current size of the back- 
ground. This is a function of 
the number of external symbols 
ond forward references that a 
program has, not a function of 
the program length. 


Abort 


BINARY CARD ENCOUNTERED INSTEAD OF CC 


A binary record was encoun- 
tered on the C device instead 
of a control command. 


Wait 


BOT ONI**" 66 

{ana, name 


Unexpected beginning-of-tope 
has been encountered on the 
specified device/Tile. 


Abort 

4. 


BUF SMALLER THAN DATA RECORD DCB xuooocxx 


Specified DCB has been assigned 
to a record size larger than the 
I/O buffer associated with the 
Reod request. Either the user has 
assigned incorrectly or the Loader 
has a program error. 


Abort 



Error Diagnostics 157 



TabU 19. Overlay Loader Dtagnestics (cent. ) 



Text 


Meaning 


Action ' 


CC ERR: BACKGROfJND AND PRIMARY 


The option PRI appeared on an 


Abort. The op- 
tion FORE must 
appear if PRI is 
Specified on the 
OLOAD command. 


ground program. 


CC ERR: DUP NAME IN ITEM xx 


. j 


Wait 


Is a duplicate of a name in 
the symbol table. 


CC ERR: DUP SEC IDE NT 


Went on :SEG command is a dup- 
licate of a previous segment's 
ident. 


Wait 


CC ERR: FOLLOWING ITEM xx 


There is an error following 


Abort if IOLOAD 
CC. Wait if any 
other CC. 


Item xx on (he command (e. g. , 
a parameter has been omitted, 
an extra parameter has been 
included, etc.). 


CC ERR: ILLEGAL CC SEQUENCE 


Loader commands have been 
ordered incorrectly. 


Wait 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (PUBL,name) 


Option (PUB LIB, name) was speci- 
fied on IOLOAD and a :PUBLIB 
command has been encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (TASKS, value) 


Option (TASKS, value) was 
specified on IOLOAD and a 
:PUBUB commond has been 
encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (TEMP, value) 


Option (TEMP, value) was speci- 
fied on IOLOAD and o :PUBLIB 
command has been encountered. 


Abort 


CC ERR: ILL OPCODE IN ITEM xx 


Specified operation code is 
either illegal or unimplemented. 


Wait 


CC ERR: ILL SEG IDENT 


Seg ident on the rMODIFY 
command does not match the 
segment being modified. 


Wait 


CC ERR: ITEM xx 


Item number xx on the command 
is in error. 


Abort if IOLOAD 
CC. Woitifony 
other CC. 


CC ERR: MODIFY OUTSIDE SEG LIMITS 


One of the locations on the 
tMODIFY command fs outside 
the limits of the segment. 


Waif* 


CC ERR: NEED (FORE,fwa, Iwa) OPTION FOR PUBLIB LOAD 


Option (FORE,fwa, Iwa) was not 
specified on the IOLOAD com- 
mand and a :PUBUB command 
has been encountered. 


Abort 
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Table 19. Overlay Leader Diagnostics (eont.) 




Text 


Meaning 


Action 


CC ERR: SEG 1DENT MOT 1ST OPTION 


Segment ident (LINK, identj) Ts 
not the fint option on the :SEG 
command. 


Wait 


CC ERR: SEGMENTS ORDERED INCORRECTLY 


:SEG commands have been in- 
put in the wrong order. 


Wait 


CC ERR: SPECIFIED AREA FOR PUBUB LOAD NOT *FP' 


Option (FILE, area, name) on 
IOLOAD did not specify the 
Foreground Programs area (FP) 
and a :PUBLIB command has 
been encountered. 


Abort 


CC ERR: STEP OPTION ILLEGAL WITHOUT ATTEND 


An IATTEND command must be 
Included in the job when the 


Abort 




STEP option is specified. 




CC ERR: UNDEFINED FILE orea,name 


Area and file specified in the 


Abort if IOLOAD 




option (FILE, area, name) has not 


CC. Woitifany 




been defined by the RAD Editor. 


other CC. 


CC ERR: UNDEFINED SYMBOL IN ITEM xx 


Symbol name in item xx on the 
:MODIFY command has not 
been defined. 


Wait 


DCB CANNOT BE A DSECT 


A DCB was encountered in the 
named segment that was as- 


Abort 


(ULIB) 


sembled as a dummy section 




SEGxxxxxlROM 


XXX 


instead of being port of the 




IsubJ 




control section. 




DCB HAS BAD PARAMETERS 


Specified DCB has bod param- 


Abort 


DCB x:xxxxxx 


eters. Either the user has as- 
signed incorrectly or the Over- 
lay Loader has a program error. 




DCB HAS INSUFFICIENT INFO 


Specified DCB contains insuffi- 


Abort 


DCB x:xxxxxx 


cient information to open a 
Read or Write operation. Either 
the user has assigned incorrectly 
or the Loader has a program 
error. 




DCB NOT ASSIGNED 


Specified DCB has been assigned 


Abort 


DCB x:xxxxxx 


to the "null" device. Either the 
user has assigned incorrectly, or 






the Overlay Loader has a pro- 


4 




gram error. 


DEFAULT ENTRY ADDRxxxxx SUPPLIED FOR ROOT 


A transfer address was not en- 
countered on any ROM in 
the Root and on entry address 
was not specified on the CC; 
therefore, a default has been 
supplied. 


Continue 
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Table 19. Overlay Loader Diagnostics (eont. ) 




T«xt 


Meaning 


Action 


DSEC'S IN PUPUB LOAD 

JULIB | 
SEGxxxxx j ROM f xxx 
ISUB ) 


Lab sled COMMON blocks 
(DSECTs) are illegal in the 
Public Libraries. 


Abort 


EOTON( yyndd 

I area, name 


End -of -tape has been encoun- 
tered on the specified device/File. 


Wait 


EXLOC TOO LARGE 
SEGxxxxx 


The execution locations of the 
specified segment will exceed 
131 K at the given EXLOC. 


Abort 


RLE DESTROYED area, name 


Overlay Looder is aborting past 
the point where data has been 
written on the specified pro- 
gram file. The first sector of 
the fi le has been zeroed out. 


Abort 


FILE UNCHANGED area, name 


Overlay Loader is aborting at o 
point where the program file is 
unchanged. 


Abort 


WARNING 
SEGxxxxx 


: ILLE 

UUB 
ROM 
SUB 


GAL LOAD LOCATION xxxxx 
xxx 


Specified "load location" origin 
has been defined with a value 
that is either not on address or 
that lies outside the address limits 
of the specified segment. (A 
lobe led COMMON block must 
be initialized in the segment 
where the block is allocated. ) 


Continue with 

COMMON 

non-initialized. 


ILL SEG IDENT TERMINATED MODIFYS 


The :MODIFY commands have 
been ordered incorrectly for 
the (GO, UNKS) option. The 
MODIFY mode has been termi- 
nated at this point. If the user 
wishes to continue, all sMODIFY 
commands that follow will be 
ignored. 


Wait 


LIB ROM'S EXCEED MAX 
SEGxxxxx 


Maximum number of library 
ROMs that can be loaded 
is 2000. 


Abort 


MEMORY CONFLICT INVOLVING PUBLIBS USED 


There is an overlap in the mem- 
ory areas used by a requested 
Public Library and either another 
requested Public Library or a user 
segment or root. 


Abort 




. 


Abort 


MONITOR 


t.4. cr 


MV- UUIN 1 CRtf JIMdlCAL/ UTiRUUI OT XUBUD 


encountered on the C device 
insteod of a :ROOT or :PUBLIB 
command. 
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Table 19. Overlay Low*. 


r Diagnostics (coot. ) 


' 


Text 


Meaning 


Action 


MOUNT PAPER TAPE tOM 


STEP option wot specified en 
IOLOAD and the next relocat- 
able object module (ROM) it to be 
input from the paper tape reader. 


Walt. Operator 
should load the 
paper tape, inter- 
rupt, and key in 

«f"ll 


NOT ENUF UDCBS 


An ASSIGN command requires 
that a DCB be built, and there 
are no unassigned DCBs (UDCBs) 
remaining. 


Continue. The 
DCB on the erring 
ASSIGN com- 
mand is not built. 


PROGRAM ERR: 


CC! 

ONE 

TWO 

MAP 

LIB 


ADDR xxxx 


Loader has a program error in 
the named overlay at the speci- 
fied address. 


Abort. Operator 
should get a core 
dump. 


SEGxxxxx 


ULIB 
ROM 
SLIB 


XXX 






PROGRAM ERR: 
DCB x:xxxxxx 


CCI 

ONE 

TWO 

MAP 

LIB 

* 


SB=xx, ADDR xxxx 


Specified error status has been 
returned from an Overlay Loader 
call (in the named overlay) to a 
Monitor I/O routine. The ad- 
dress of the CAL and the name 
of the DCB are specified. 


Abort 


PROGRAM 
SEGxxxxx 


ERR: I 

ULIB 
ROM 
SLIB 


JNALLOCATED CSECT 

XXX 


Loader has encountered a con- 
trol section that has not been 
allocated; either a Loader, 
compiler, or assembler error 


Abort 


PROGRAM FILE HEADER EXCEEDS ONE SECTOR 


Size of program file header was 
found to be greater than one 
sector. 


Abort 


RAD FILE TABLE FULL 


RAD File Table size that was allo- 
cated at SYSGEN is insufficient. 


Abort 


READING AN OUTPUT DEVICE 
DCB x:xxxxxx 


A DCB that the Overlay Loader 
reads with has been assigned to 
an OUT device. Either the user 
has assigned incorrectly or the 
Looder has a program error. 

< 


Abort 


ROM ERR: 
SEGxxxxx 


BAD S 

ULIB 
ROM 
SLIB 


EQ 
xxx SEQNOxxx 


Sequence number of the binary 
record does not equal xxx. 


Wait 
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Tabic 19. Overlay Loader Diagnostics (cont. ) 



Text 



Moaning 



Action 



IOM ERR: EXPRESSION SIZE EXCEEDS MAX 

[ULIB ] 
SEGxxxxx {ROM |xxx SEQNOxxx 
ISL1B J 



An object longuage expression 
on the specified binary record 
exceeds 120 bytes. 



Abort 



ROM ERR: ILLEGAL LOAD ITEM 



SEGxxxxx 



ULIB 
ROM 
SLIB J 



xxx SEQNOxxx 



Object longuage on specified 
binary record cannot be trans- 
lated (assembler or compiler 
error). 



Abort 



ROM ERR: NO MODULE END 



SEGxxxxx 



ULIB 

ROM 

ISUB 



xxx SEQNOxxx 



Module end was not encoun- 
tered on the lost binary record 
of the relocatable object 
module. 



Abort 



Specified binary record is not 
in object language format. 



ROM ERR: NOT OBJECT LANGUAGE 

ULIB 
SEGxxxxx { ROM | xxx SEQNOxxx 
SUB 



Wait 



ROM ERR: NOT STANDARD BIN 



SEGxxxxx 



ULIB 
ROM 
SLIB J 



Specified record has a non- 
standard binary format. 



Wait 



xxx SEQNOxxx 



SMM OPTION ILLEGAL WITH FGD OR PUBLIBS 



Simplified Memory Management 
is legal only for background 
programs. 



Abort 



The symbol xxxx occurred •■■ 
the same path with the two 
usages indicated. . 



SYMBOL DECLARED BOTH AS DEF AND DSECT: xxxx 



tn 



Abort 



TOO MANY ROM FILES 



The maximum number of ROM files 
that can be loaded is 127 per 

segment. 



Abort 



UNDEFINED RLE area, name 
DCB x:xxxxxx 



Specified DCB has been assigned 
to e disk file that has not been 
defined by the RAD Editor. 



Abort 



UNDEFINED ORIGIN 



SEGxxxxx 



ULIB 
ROM 
SUB 



xxx 



UNEXPECTED EOD ON {**"** 

I area, name 



Looder has encountered a "load 
location" origin with an expres- 
sion that cannot be resolved. 



Abort 



Unexpected IEOD was encoun- 
tered on the specified device/File. 



Wait l{me IEOD 
was encountered 
instead of a ROM; 
otherwise, Abort. 



UNEXPECTED MONITOR CC ON 



{yyndd 
areo, 



Unexpected Monitor control 
command was encountered while 
reading ROMs from the C device. 



Abort 
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Table 19. Overlay Loader Diagnostics (cant. ) 



| T .xt 


Meaning 


Action 


UNRECOVERABLE RD ERR ON f yyndd 

I area, name 


Transmission error has occurred 
while reading from the ipeci- 
fi led device/File. 


Abort 


UNRECOVERABLE WR ERR ON f W^ 

(.offec, name 


Transmission error has occurred 
while writing on the specified 
device/File. 


Abort 


WARNING 
SEGxxxxx 
DCB x:xxxx 


: DCB IN OVERLAY SEGMENT 

ULIB] 

ROM xxxSEQNOxxx 

SUB) 

XX 


Specified DCB was declared an 
external DEF in a segment other 
than the Root. The DCB will 
not be included Tn DCBTAB. 


Continue 


WARNING: DEF'D DCB NOT DEFINED 
DCB x:xxxxxx 


Specified DCB was declared on 
external DEF and the DEF was 
never defined. 


Continue 


WARNING: DUPUCATE DEF'S 


User's program contains dupli- 
cate external DEFs. Map will 
indicate the name(s) of the DEFs. 


Continue 


WARNING: DUPUCATE REF'S 


User's program contins dupli- 
cate external REFs. Map will 
indicate the name(s) of the 
REFs. Occurs when identical 
DEFs in different segments of 
different paths are referenced 
by the same REF 0" ° segment 
common to both paths). 


Continue 


WARNING: ENTRY ADDRxxxxx OUTSIDE SEGMENT 
SEGxxxxx 


Entry address for the specified 
segment is outside the segment's 
address limits. 


Continue 


WARNING: ILLEGAL DCB ADDR 
DCB x:xxxxxx 


Specified DCB was declared an 
external DEF and the DEF has 
been defined with either a neg- 
ative oddress or a constant. 


Continue 


WARNING 

SEGxxxxx 

DC6x:xxx> 


: ILLE 

ULIB 
ROM 
SUB 

OCX 


GAL DCB NAME 

XXX 


Specified DCB name is illegal 
and will not be included in 
DCBTAB. Monitor DCBs(M:> must 
have standard OP LB names. User 
DCBs(F:) must not exceed eight 
EBCDIC characters in length. 


Continue 


WARNING: LCC 
ALLOCATED 

(ULIB 
SEGxxxxx I ROM 

(sub 


>M name OF SIZE xxxx GREATER THAN 
XXX SEQNOxxx 


The named labeled COMMON 
block (DSECT) with the size 
specified in words is greater 
than the size allocoted. 


Continue 
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Tabic 19. Overlay loader Diagnostics (cant. ) 




Text 


Moaning 


Action 1 


WARNING: NO ENTRY ADDRESS FOR ROOT 


Root does not hove on entry 
address. 


Continue j 


WARNING: OVERLAY SEG GREATER THAN 16 K 


Specified overlay segment ex- 
ceeds the maximum size record 
that con be loaded by the Mon- 
itor SEG LOAD function. 


Continue 


WARNING: PROGRAM EXCEEDS SPECIFIED ADDR LIMITS 


User's program exceeds the od- 
dress limits, either specified on 
IOLOAD or the defaults for 
background/foreground 
programs. 


Continue 


WARNING: PROGRAM FILE RSIZE NOT EQUAL TO GSIZE 


Record size of the program file is 
different from the granule size. 


Continue 


WARNING: UNDEFINED DEF'S 


User's program contains external 
DEFs that either hove not been 
defined or have been defined 
with an expression the Loader 
cannot resolve. Map will indi- 
cate the nome(s) of the un- 
defined DEFs. 


Continue 


WARNING: UNDEFINED ENTRY ADDR 
SEGxxxxx 


Expression defining the entry ad- 
dress for the specified segment 
cannot be resolved by the 
Loader. 


Continue 


WARNING: UNSATISFIED REF'S 


User's program contains unsatis- 
fied external REFs or unallocated 
DSECTs. Map will indicate the 
name(s) of the REFs and DSECTs. 


Continue 


WRITING ON INPUT DEVICE 
DCB x:xxxxxx 


A DCB that the Overlay Loader 
writes with has been assigned to 
an IN device. Either the user 
has assigned incorrectly or the 
Loader has a program error. 


Abort 


yyndd WRITE PROT 


Specified RAD is write -protected. 
Condition is brought obout by 
system write protection or hard- 
wore write protect violation. 


Wait and 

1. Reset RAD pro- 
tection switches 

or 

2. Interrupt and 
key in "SYC", 

or 

3. Interrupt and 
key in "X" if 
the job is not 
allowed rewrite 
on protected 
areas of the RAD. 
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USER LOAD-TIE ASSWtS 



COMMON AUOCATWN 



MDC6 ANO F-.DCI 

DCBs identified by extemol definitions must exist in the 
root for each unique reference to an M:DCB or F:DCB. 
These are either inserted explicitly by the user or built im- 
plicitly by the Loader. A user eon change DCB assignments 
in several ways: 

1. By modifying the DCB at execution time. 

2. By using a load-time 'ASSIGN (foreground and 

background). 

3. By using a run-time 1 ASSIGN (used by background 

jobs). 



RUNTIME ASSIGNS 

Run-time lASSlGNs (by Job Control Processor) apply only 
to the background job step in which they are inserted. 
Change of assignment for foreground programs is permitted 
only through STDLB operations, load-time : ASSIGNS, or 
DEVICE (setdevice/File/oplabel index) CALs. 



LOAD-TIME ASSIGNS 

Load-time :ASSIGNs ore changes to the respective DCB at 
load-time, so that the given assignment remains as a part of 
the program. This effectively allows assignments for fore- 
ground programs, and assignment of DCBs with nondefault 
eases. 



BLANK COMMON 

By default, blank COMMON is allocated beginning or the 
end of the longest path as illustrated in Figure 21. 





1 




Blank 




2 


4 


Root 


3 


Part 1 


COMMON 













Root 
Part 2 



F4:COM 



P:END 



Figure 21. Blank COMMON Allocation by Default 

The default size of blank COMMON is determined by the 
size of the largest blank COMMON encountered during 
the loading of all segments. 

An optional COMMON control command allows the user to 
specify the size and/or location of blank COMMON, or to 
force it to follow the segment defined most recently when 
the COMMON command appeared. In the following ex- 
ample, the COMMON command is used with no param- 
eters. The size then defaults to that in the first ROM that 
references blank COMMON, and the location is the first 
boundary (doubleword or specified) past the previous end- 
of-segment. Figure 22 diagrams the resulting memory 
layout. 

:ROOT. . . 



FORTRAN INTERFACE 

System interface between FORTRAN -produced programs and 
CP-R is the shared responsibility of the FORTRAN compiler- 
Loader-CP-R complex. This complex enables the user to 
program real-time programs for foreground operation using 
Real-Time FORTRAN language without having to use sym- 
bolic coding to create the system interface (see FORTRAN 
job examples in Chapter 12). 

Symbolic code and control information can be used to give 
the FORTRAN user added versatility in cases where compat- 
ibility with other FORTRAN configurations is not a factor. 
However, such coding is not required. That is, the user can 
write and execute a program to service real-time interrupts 
without any symbolic embellishment of the FORTRAN 
language and without destroying the real-time response 
required. 



:SEG (UNK,1)... 
.•COMMON 
:SEG (UNK,2)... 
:SEG (LINK, 3)... 
:SEG (LINK, 4)... 

Note that in Figure 22, segment 1 sets trie COMMON base 
so that segments 1, 2, and 3, share all COMMON, but seg- 
ment 4 overlays a portion of COMMON. Thus, segments 1, 
2, and 3, might operate on a large array, leaving the results 
In upper COMMON for segment 4, which can reclaim the 
remainder of the COMMON storage. However, a care- 
fully determined COMMON allocation in segment 4 would 
be necessary to align references to the upper portion of 
COMMON. 
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Root 


1 






Root 
Port 2 

P:END 


2 




Blank 


3 


Port 1 


COMMON 

4 






F4:COM 



Figure 22. Blank COMMON Option 



CALUM OVERLAY SEGMENTS 

The Overlay Looder generates no Implicit calls for boding 
overlay segments, ond generates no explicit code for such 
calls. FORTRAN programs to be run in overlay form must 
call the FORTRAN run-time routine SEGLOD (or its op- 
tional alternate name, SEGLOAD), which calls the SEG- 
LOAD function of the Monitor. The identification numbers 
In the argument list must correspond to the identification 
number on the SEG control command. Programs that use the 
SEGLOAD function must be either background programs 
loaded with the SMM option on the OLOAD command, or 
primary foreground programs. 

The SEGLOAD function calls in the overlay segment ond 
returns, e.g., 

CALL SEGLOD (I) 



LABELED COMMON 



CALL SUBROUTINE 



Labeled COMMON is allocated by the Loader either by de- 
fault in the segment in which the block is first encountered, 
or specifically, by the parameters on the LCOMMON con- 
trol command. All references to a labeled COMMON block 
must be in the same path as the definition. Note that la- 
beled COMMON in the root is available to oil segments. 
A labeled COMMON block must be initialized in the seg- 
ment that is allocated. 

The :LCOMMON control command will allocate labeled 
COMMON in the segment specified by the preceding :SEG 
command, or will cause its allocation to be deferred until 
a subsequent : LCOMMON or :RES command. The example 

:LCOMMON (A, 100), (B, 101), (XRAY,50) 



( 



SEG (LIN K, 201, ONTO, 0) 



will allocate a labeled COMMON block /A/ of 100 words, 
a block /B/ of 101 words, ond o block /XRAY/ of 50 words 
in segment number 201. 



CONNECT 



where I is the segment ident. 



MAIN PROGRAM NAME AN0 ENTRY 

The entry point of o FORTRAN main program is not neces- 
sorily the first location of the p rogram. The compiler will 
output an external definition to identify it as a FORTRAN 
main program. The entry point for that program is either 
the transfer address of the main program, or the value spec- 
ified with the ENTRY keyword on the :ROOT command. 



LABELED COMMON NAMES 

Labeled COMMON blocks are identifiedas DSECTs, labeled 
with on external definition the same as the block name. 



■LANK COMMON NAMES 

Blank COMMON references are identified os DSECTs with 
the unique extemol definition name F4:COM. 



The Loader does not provide any facility for generating 
code to connect foreground programs to interrupts or to 
trigger interrupts. The CONNECT statement in FORTRAN 
plus the Monitor CONNECT call provides the necessary 
interface. 



CORE LAYOUT AT EXECUTION TIME 

The core storage area allocations for a typica^egmented 
program are illustrated in Figure 23. 
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Program 

Area 



PCB 



Optional Space for BOUND 



Root Code (Iter Programs) 



Root Library Programs 



LCOMMON (root only) 



RES (optional) 



SEG1 



SEG2 



SEG3 



SEG4 



Blank COMMON 



OVLOAD Table 



Loader Created DCBs 



DCBTAB 



User Temp Stack 



CP-R Temp Stack 



SEG5 



FWA of Program 



Part one of root segment 
output to Program File 



FWA Overlay Area 



(BOUND and RES not shown! 



LWA of Overlay Area 

FWA of base of Blank COMMON (F4:COM) 



FWA of part two of the root 



Part two of the root 



LWA + 1 of Program (P:END) 



Figure 23. Standard Core Layout of a Program 
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11. RADEDIT 



RADEDIT is a background processor that performs allocation 
if disk areas by generating and maintaining directories for 
II permanent files. Through commands input by the user, 

RADEDIT performs the following functions: 

Adds or deletes entries to the permanent file directories 
that, in turn, allocate and re lease ' permanent space 
within a disk area. 

Copies data files to and from disk. 

Copies data files from device to device. 

Appends records to the end of an existing disk file. 

Compacts permanent file directories and permanent 
disk areas . 

Truncates empty space from the end of disk f i les . 

Maps permanent disk file allocation. 

Maps library module allocation. 

Dumps the contents of disk files, areas, or tapes. 

Copies permanent disk files. 

Copies object modules contained in the libraries. 

Saves the contents of disk areas on a magnetic tope 
device in a self-reloadable form. 

Restores previously saved disk areas to their disk 
location . 

Maintains library files on disk for use by the Overlay 
Loader. 

Zeros out (clears) complete disk areas. 

Temporarily inhibits the use of bad disk sectors. 



RADEDIT controls file allocation by generating and 
maintaining a directory entry for each file within the obove 
permanent areas. Every permanent area has a directory that 
begins in the first sector of its own area. A directory con- 
sists of entries with the following information: 

• File name (maximum length of eight alphanumeric 
characters). 

e Resident foreground program flag. 

e File type; blocked; unblocked, or compressed. 

e Granule size in bytes (used for direct access). 

e File size (current number of records in file). 

e Record size (bytes per logical record). 

e Relative disk address of the first sector defined for 
the file. 

e Relative disk address of the last sector defined for 
the file. 

e Extension allocation size. | 

Before any permanent disk file can be written, space 
must be allocated for the file by adding a new entry to the 
designated directory. Directory entries may be added or 
deleted by using RADEDIT commands. The following method 
is used to allocate files-. 

1. Permonent disk files ore allocated sequentially, begin- 
ning in the second sector of the area, with tvery file 
beginning and ending on a sector boundary. 

2. A new directory entry is added as the lost entry to the 
existing directory and the corresponding space for the 
file is allocated. 



OPERATING CHARACTERISTICS 

FILE ALLOCATION 

RADEDIT performs disk allocation for all permanent files. 
The name, size, and location of each permanent disk 
area are indicated through the user of a Master Directory 
that is set up at system generation in the resident portion 
of CP-R. The permanent disk areas maintained by RAD- 
EDIT are 

Background programs (BP). 

Data (Dl-DF) and user defined areas. 

Foreground programs (FP) contain User Library. 

System programs (SP) contain System Library. 



3. When all available space in an area is exhausted, a 
complete search of the file directory is made for un- 
allocated areas made available through file deletions. 
The smallest area containing a sufficient amount of 
space to allocate for the file is selected. V sufficient 
space is not found upon searching the directory, the 
operation is aborted. To overcome this problem, disk 
squeezing may be requested to recover the unused stor- 
age within a permanent area by compressing the direc- 
tory entries and files (see Figures 24 and 25). 

4. File deletion Is accomplished by zeroing out the appro- 
priate directory entry. m 



SKIPPMS BAD SECTORS 

When a bad disk sector^) is discovered, it is the user's re- 
sponsibility to prevent it from being used by deleting the 
defective file, declaring the bod sectors) with :BDSECTOR, 
and reallocating the file if it is to be regenerated. 
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Figure 24. Permanent Disk Area Before Squeezing 
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Figure 25. Permanent Disk Area After Squeezing 



The method used to handle bad sectors is as follows: the 
rBDSECTOR command removes the sectors from use by plac- 
ing a special entry in the file directory and allocating the 
space as a file. The tGDSECTOR command returns the disk 
space for use by deleting the file directory entry. 



OS blocked or unblocked. As an aid in approximating the 
file sixes, the user can use the algorithms given below. 

i i 

RADEDIT is the only processor that should write in the 
librory files. The files ore generated from information con- 
tained in the object modules read in by RADEDIT. Each 
module is identified within the library files by a DEF. 
The first DEF encountered In the module is considered the 
module name, and no ether DEF in a program will be so 
recognized. Any module may be referenced by using the 
first DEF in a program, and modules may be copied or de- 
leted through its use. This module name may not be the 
tame form as a DCB name (i.e., beginning with "M:" 
or "F:">. 



ALGORITHMS FOR COMPUTING LIBRARY FILE SIZES 

The following algorithms can be used to determine the ap- 
proximate sizes of the four files in a library. It is not cru- 
cial that the file sizes be exact, since any unused space 
can be recovered via the :TRUNCATE command. The ap- 
proximate number of sectors ^>i<A n i D ) required in the 
MODIR file is MODIR 



MODIR 



.3 0) 



i is the number ofmodu let to be placed in the library. 

s is the sector size in words . 

3 words is the length of a MODIR file entry. 

The approximate number of sectors ("egrniC^ r *V' r *°' ' n 
the EBCDIC file is 

2(d) 
"EBCDIC " "7" 

where 

d is the unique number of DEFs in the library. 

s is the sector size in words . 

2 words it the average length of an EBCDIC fi le entry. 



SYSTEM AND USER LIBRARY FILES 

System and User Library files are searched by the Overlay 
Loader to satisfy external references. These files are gen- 
erated and maintained by RADEDIT in a form that can be 
rapidly and easily searched by the Overlay Loader. The 
System Library files must reside in the System Programs (SP) 
area, and the User Library files must reside In the Fore- 
ground Programs (FP) area. Each library consists of three 
unblocked filet: the Module Directory File (MODIR), 
DEFREF File (DEFREF), and EBCDIC File (EBCDIC), and 
one blocked file: Module File (MODULE). The user must 
define and allocate these library files using the file names 
that appear within parentheses above and defining the files 



The number of records K^oqijLe' "tquired in the MODULE 
file is 



"module = | i* 1 C l "* 



where 

n Is the total number of modules in the library. 

C; is the number of card images in the ith librory 
routine. 
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The number of sectors (>Wa>cp) ^ *• DEFREF file b 



COMMAND FORMATS 



i + 



v« 



1 = 1 



'DEFREF 



where 

n it the total number of routines in the library. 

6 " it the number of DEF* in the irh library routine, 

r it the number of REFs in the ith library routine, 

t it the sector tize in words. 

DISK AREA PROTECTION 

Updating or squeezing of permanent disk areas containing 
information for real-time programs (foreground program and 
foreground data areas) must not occur while the foreground 
is utilizing these permanent areas. The user must ensure 
that RADEDIT is not modifying a permanent area at the 
tame time a foreground program is using it. 

Software protection of the System and Foreground Data areas 
of the disk Is provided by requiring the operator to key in 
"SY" before any of these areas are modified by a back- 
ground processor. The only areas that can be modified that 
do not require a SY key-in are the Background and Public 
Data areas. 



AH RADEDIT commands are input from the C 'device and 
listed on LL. The general form for RADEDIT command' '• 
identical to the control command format described in C 
tar 2, with the symbols below being used to aid in descr Fl- 
ing RADEDIT commands in this chapter. 

aa refers to a disk area and must be one of the 
following; 

BP it the Background Programs area . 

D1 through DF or user defined areas. 

FP it the Foreground Programs area . 

SP it the System Programs area. 

IT is the Background Temp area (can be used 
with :COPY, :CLEAR, or .-DUMP). 

fid is a CP-R file identifier, with standard defaults. 

zz refers to any disk area . 

nrmnrmnn refers to a file name or library module 
(maximum name length of eight alphanumeric 
characters) . 

yyndd refers to a physical device name, where 

yy specifies the type of device: CR, CP, etc. 

n specifies the IOP number: A for IOP0, 
Bfor JOP1, etc. 

dd specifies the device number: 03, 60, etc 

OP refers to an operational label: BI, SI, etc. 



CALUNG RADEDIT 

When a I RADEDIT control command is read from the C de- 
vice, RADEDIT is loaded into core memory from the disk. 
Control is transferred to the RADEDIT which roods com- 
mands from the C device that specify the functions to be 
performed. 

The form of the command is 



r 



I RADEDIT 



RADEDIT Is terminated when a record with an I in column 
one it read from the C device (with the exception of IEOD). 
An IEOD indicates an end-of-dato to RADEDIT when dato 
it input via the :COPY command. 

When RADEDIT Is called from TJE, the commands SAVE, 
RESTORE, CDSECTOR, BDSECTOR, and SQUEEZE ore not 
available. 



RADEDIT COMMANDS 

t ALLOT The tALLOT command odds a new entry to the 
specified permanent file directory that allocates space for 
a new file. After space has been allocated, filet can be 
written by either background or foreground programs. The 
space allocated for the new mntry it zeroed out. 

The form of the command it 

ALLOT (FILE, fid) [, (option]... [, (option)] 



where the options ore 

FORMAT, type specifies the file format where type is: 

U far unblocked. * 

B for blocked. 

C for o co mpr es sed file. 
The default valve is unblocked. 

FSIZE, value specifies the decimal length of the 
file in logical records. The default value it 1000. 
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tSTZE, value •pecrfics the decimal number ofe u i ds 
par record. T1m logical record lis* is mad in ae- 
quentiolly ac cawing a ill*. Far a compressed file, 
record size It oaiiftod and the Manlier block* eom- 
pranod film into 256-word records. Modcod files 
hove a default value equal to 128 words per rec- 
ord. If the record size Is greater than 128 wards, 
unblocked organization will be given. Unblocked 
files have a default record size equal to the gran- 
ule size. 

GSIZE, value opacifies granule size in words and is 
used for direct access only. The default size will 
be equal to the sector size. 

RF indicates that the file contains a resident fore- 
ground program and is applicable only if the FP 
area is specified. F RF is omitted, the file does 
not contain a resident foreground program. Any 
program flogged as resident fo r e gr o und will be 
automatically loaded into care every time the sys- 
tem is booted from disk. 

ESIZE[,volueJ specifies the decimal length of file 
extents in logical records. An extent is allocated 
end attached to the file anytime the file is out of 
space. If the optional value is omitted, file ex- 
tents will be the same size as the original file. If 
the ESIZE parameter is not specified, no automatic 
file extension will take place. 

FIX indicates that during a squeeze of the specified 
area, the file is not to be combined with its ex- 
tents. If fix'is not specified, the original file will 
be combined with all of its extents to form one file 
if the area is squeezed. 

The FIX option is applicable only if the ESIZE op- 
tion is present. 

Examples: 

1. An unblocked file: 

/:ALLOT (FILE,D3,TEST), (FORMATS). (FSEE^O).-i 



-(RSIZE,90) 



This example allocates space for the unblocked file 
TEST in the D3 area of the disk, with a file size of 
50 records and a record size of 90 words. 

2. A blocked file: 



:ALLOT (FILE,FP.TESTA),(FORMAT,B).- 



/•AU 

1^ 



The tCOPY co mmand copies files of data or 
Modules (EBCDIC, UNARY in standard binary format, or 
non stan d a rd binary) from one device to another.* Files are 
copied until an IEOO or tape mark is encountered, except 
when the CC option is specified, which is terminated when 
an :EOO is encountered. Individual records in the file may 
be as large as 64K bytes if buffer space is available . A 
logical file mark will be written onto the output file. 

On 7-trock tape, a copy from a file to a device assigned to 
an op label will be in packed binary format. V a device is 
specified, the information (data) will be written unpacked. 

When n on s t a ndar d binary (BIN) or control commands (CC) 
are copied from the C device, the C device must be assigned 
to end reassigned after the copy is completed. The as- 
signment is mode when the maiiogr 

NKEYINSTDLBCO 
is typed to the operator ond reassigned when the message 

1 1 COPY ENDED, REASSIGN C . 
appears. 

An IATTEND card must be used to force a pause for operator 
intervention whenever the BIN and CC options ore specified. 

The general form of the command is 



:COPY( 



FROM 

FILE, fid 
LIB,oa,nnnnnnnn 



), ( 



TO 

FILE, fid 
LIB,oo 



C 



'lyynddj 

[,VFCl^DD][,UPD][,BlN][,CC][,FBCD]- 
[,(NFIL,£ LL ))] [,ASa]L>SCO] 



)-i 



wncrc 



(FSIZE,50).(RSIZE,256),RF 



FILE indicates either a disk file or a whole disk | 
area. Areas CK ond XA are only allowed as input 
files. 

LIB indicates a library object module (j) in the SP 
or FPerea. 

IN indicates an input operation from a non-disk 
device is to be performed . 

OUT indicates an output operation to a non-disk 
device is to be performed. 

VFC indicates vertical format control is desired on 
printing . ^ 

ADD Indicates records are to be added to the end 
of an already existing file. 



This example allocates space for the blocked file TESTA 
in the FP area, with a record size of 256 words and a 
file size of 50 records. This is o resident foreground 

program. 



File-to-file copies should be between files with the some 
RSIZE. 



RADEDTT Commands 171 



UPD Indicates records or* le be odds J storting ot 
the current position of Ik* flU. Nermolly, »he 
III* would be r ewo und before llw copy started. 

I1N specifies that naratandard binary Information 
is to bo copioa tram the cord reader or to the card 
punch. 

CC specifics that control co n ei nnd s am to be 
copied from the C device. 

FBCD specifies that BCD input is to be converted 
to EBCDIC. 

(NHL,{^ LL j) cpecifiet thot multiple files are to 
be copied. If n is specified, n files 
will be copied; if ALL is specified, the cap/ will 
continue until o double EOF is rood. The default 
is to copy one fi le. 

ASCI specifies that ASCII input is lo be converted 
to EBCDIC . 

ASCO specifies that EBCDIC output is to be con- 
verted to ASCII. 

The following are examples and explanations of the differ- 
ent types of copies that can be performed. 

Examples : 



COPY 



( ,N < \yyJi) ' (F,LE ' fid) 



This example copies a file of dota onto the specified disk 
file. 



|/,ccnr(iN i {r dd )), (FILE, fid), CC 



This example copies a file of dato containing control 
monds from the C device onto the specified disk Tile. 

| ^OPY(lN, (^j), (FILE, fid), ADD 



This example odds data to the end of an already existing 
disk file. 



f / KIOf.Y(.N,( y ^ ndd )),(UB.ao) 



This example copies the library object modules to the speci- 
fied library. The library being copied will completely re- 
place an already existing library. 



r 



*™ ( ,N « (Jyndd}) W*-^ 



■This 

*M0 IIMQfy* 



■SOB flw leOPBfy Ob|#Ct eMOduVaM tO Ntel I 



f 



COPY (FILE, fid). (FILE, fid) 



This example copies the contents of the first specified disk 
file to the second specified disk file. 



COPY (UB,ao,imnnnnnn 



). (out. 



op ) 

vyndd / 



This example copies one library object module to the speci- 
fied output device. The "nnnnnnnn" par a meter is the name 
of the library "object module to be copied. 



.-COPY (FILE / fid),(0UT,( o £ iA ,}),VFC 



This example lists the contents of on EBCDIC file with 
vertical format control. 



.•COPY 



(FILE,fid), (OUT,^}) 



This example copies the contents of the specified disk file 
onto the specified device. 

••COPY {FILE, fid), (0UT,[ Op ndd |),MN 



This example copies nonstandard binary from the specified 
disk file to the cord punch. 



A 



:COPY(nu.«),(ouT.(J$ n<t| )) 



This example copies the contents of the K>EX access (XA) 
or Checkpoint (CK) areas to the specified output device. 



dKOPY The tDPCOPY co mm an d capias rhe contents 
of one disk pack to another disk pock. The entire contents 
of the disk is copied (except far the alternate track area) 
unless otherwise specified. 
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The tDFCOfY co mme nd has the farm 
/jDPCOPY (yyndd, yyndd) [,CKRD][£lCWT3,- 



The form of the commend it 



EZ 



G<SSEC,n]tl[,(NSEC,m)] [, (OSEC, p)3 



yyndd ore the physical device names of the disk 
storage devices. The first disk is the input device 
and will be copied to the second device. 

CKRD indicates that read-check will be done when 
reading the input device. 

CKWT indicates that a write-check will be done 
when writing the output device. 

(SSEC,n) specifies to begin the copy with sector n. 
The default is to start at sector 0. Note that 
SSEC can apply to the input and output disk. 

(NSEC,m) specifies that m sectors should be copied . 
The default is to copy through the last user occeis- 
able sector. 

(OSEC/p) specifies that the output is to start at 
sector p. If this parameter is not given, the SSEC 
value is used. If it is used, p + m must be less 
than or equal to the last sector on the disk . 

:0ELETE The :DELETE command deletes either a file di- 
rectory entry and file from a permanent disk area, or an ob- 
ject module from the designated library. The space formerly 
allocated is not used until a :SQUEEZ£ is executed. 

The forms of the :DELETE command are 

dpi cTcI'-'^' oa ' nnnnr,nnn l 
:DtLtTt lFILE / fid J 



Examples: 

1. Delete a file: 

^DELETE (FILE, BP, TESTA) 

2. Delete an object module: 



r 



-.DELETE (LIB,SP,CSCN) 



This example specifies that an object module named 
CSCN is to be deleted from the Library In the SP area. 



:CLEAA The rCLEAR command zeros out the specified 
disk areas which results in deleting all files and file direc- 
tories tn the area. 



r 



rCLEAR zz,zz, . . . 



where zz is any disk area. 



Example: 



r 



£LEARD1,DF 



This example specifies that permanent areas 01 and DF are 
to be zeroed out. 



SQUEEZE The .'SQUEEZE command regains unused 

space within permanent disk areas resulting from file dele- 
tions and truncations and library module deletions. Unused 
space is regained by compressing Tile directory entries end 
their associated files, or library file entries and their as- 
sociated library modules. Within the libraries, the Module 
Directory File (MODIR) end the Module File (MODULE) 
entries and modules are compressed to regain the unused 
space. Space is regained in the remaining two files, 
EBCDIC File (EBCDIC) and DEFREF File (DEFREF), by re- 
generating them completely from the Module Directory and 
Module Files. Extreme cere should be exercized to ensure 
there is no file activity going on in the area being squeezed - 

The forms ot tno command ore 






SQUEEZE aa,aa,aa, 



SQUEEZE ALL 



:SQUEEZE (LIB,oa) 



Examples: 

1. Regain unused space in specified drVa: 



r 



:SQUEEZE SP 



This example regains unused space between files the 
SP area only, without affecting the internal structure 
of the SP Library. 
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2. Regain space in all pe r mane nt disk oreos. 



r 



3. 



tSOUEEZE ALL 



This example regoins unuMd space bttwiw all flics 
in all permanent areas. Libraries are nor squeezed. 



r 



:SQUEEZE (LIB,SP) 



This example regains unused library space in the SP 
Library. 



This 



le truncates all File* in the »P # D2, and D3 



MAP The :MAP command maps the specified permanent 

disk areas fo the LO device (using the M:LO DCB) . The 
map contains 

1 . Information concerning the area, consisting of the disk 
address, write protection, area identification, words 
per sector, sectors per track, and its beginning and end- 
ing disk addresses. 

2. Information from the Permanent File Directories con- 
cerning each file In the area; file name, format, 
beginning file address, ending file address, file size, 
record size, granule size, and resident foreground pro- 
gram indicator. 

The tonus of tne commono ore 



(TRUNCATE The : TRUNCATE command is used to trun- 

cate empty space from the end of specified file(s). H the 
allocated disk space for a file is greater than the actual 
length of the file, a considerable amount of space may be 
left empty. This command will set the allocated space 
equal to the actual length of the file. 

The forms of the command are 



•.TRUNCATE (FILE, fid), (FILE, fid) . . ., (FILE, fid) 



1. 



:TRUNCATEoa,ao,oa,... 



Examples: 

1. Truncate allocated file: 



:TRUNCATE (FILE, BP, TEST) 



This example truncates empty space from the end of the 
allocated file TEST in the BP orea by setting the allo- 
cated size equal to the actual size of the file. 

2. Truncate all files: 



•.TRUNCATE BP,D2,D3 



r 



tMAP oa ,oa,oa, ... 



2. 



( 



tMAP ALL 



Examples: 

1. Map specified permane n t disk areas: 
/sMAP BP,D4 



This example outputs a map of the permanent areas BP 
and 04 of the LO device. 



2. Map all permanent disk areas: 



r 



:MAP ALL 



This example outputs a stop of all permanent areas to 

the LO device. « 

■*« 

An example of a MAP SP output b illustrated in 
Figure 26. 



:SMAP The :5MAP command produces a special, short 
map of the files in the specified areas. The command has 
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Figure 26 . MAP SP Output Example 



the tame format as the :MAP command. The output on the 
LO device (using the M:LO DCB) for each area specified 
consists of 

1 . The name of the area . 

2. The name of each file, its account, and number of 
records; or, if there ore no files, the menage "AREA 
CONTAINS NO FILES". 



The :LMAP command maps the library files of the 
specified permanent directory to the LO device using the 
M:LO DCB. For each area (SP or FP), all library files in 
the area are mapped. The library map includes information 
about the object modules in the library files that consists of 
the name of each module, its relocatable length, and def- 
inition and references in the module. 



The form of the command is 
/:LMAP aa[,ao)] 



where aa specifies the SP or FP area . 

Example: 



:LMAP SP 



This example specifies the files in the SP area and its asso- 
ciated library are mopped. 
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:CATAL06 71m CATALOG command it UMd to pat file 
six* and organization information cither about a particular 
fila or about a group of filet in a particular account and/or 
area. The two forms of the command determine the type of 
processing* 



Form 1: a particular file. 
/•CATALOG <fid)[, (fid), . . .] 



where fid is the standard file identifier. 

This form will display the file information for the named 
files. 



Form 2: for a group of files. 
/•CATALOG 



(fid')[,([0[,0)] 



clumped. Files ore dumped by 
The EBCDIC is not given. 

The forms of the command are 



records, areas by sectors. 



f 



•.DUMP (FILE,fid)[,(SREC, volue)][, (EREC, value)] 



where 

fid is any allotted file. 

SREC, value specifies the starting record (in 
decimal) to begin the dump. 

EREC, value specifies the last record to be 
dumped. 



where 

fid' is a standard fid with a null file name (e.g., 
.SPor .ACCOUNT or .). 

f is a starting sort key. Its format is the same as 
the 'name' field of a fid. It need not be an ac- 
tual file name. 

t is an ending sort key in the some format as f above. 

This form will display all files in the area(s) and account 
specified. If an area is given explicitly, only that area 
will be displayed. If an account is given explicitly, only 
files in that account will be displayed. The account is de- 
faulted to the user's account if it is not specified. 

The information displayed consists of the filename, the ac- 
count name, the area the file is in, its organization, and 
the number of records in the file. The output is sorted al- 
phabetically by file name and account name. 

The "f" and "t" parameters allow the list of files to be 
limited to a particular range. Neither "f" nor "t" must be 
actual file names. If "f" ("t") is given, files with names 
alphabetically before (after) it will not be displayed. If 
"f" ("t") is not given, the first (last) possible name is used 
as the default. 



■DUMP The :DUMP command dumps, in hexadecimal, 

the designated random or sequential access file onto the 
LO device (using the M:LO DCB). All permanent areas 
plus the lOEX Access area (XA), Background Temp area (BT), 
and Checkpoint area (CK) can be dumped. The KADEDIT 
will sequentially access the designated file or area to be 



.•DUMP zz[,(SREC, value)] [, (EREC, value)] 



where 

zz is any disk area. 

SREC,value specifies the starting sector (in 
decimal) to begin the dump. 

EREC, value specifies the last sector to be 
dumped. 



Examples: 

1. Dump specified file: 

/DUMP (FILE, BP, TEST) 



This example specifies that the TEST file in the BPorea 
is to be dumped onto the LO device. 

2. Dump specified records: 



r 



DUMP (FILE,BP,TEST),(SREC,10), (EREC,20) 



This example specifies that records 10 through 20 of 
the TEST file in the BP area are to be dumped onto 
the LO device. 
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3. Dump specified sectors: 



r 



DUMP BP,(SREC,6),(EREC,9) 



This example specifies that sectors 6 through 9 of the 
6P oreo ore to be dumped onto the LO device. 



4. Dump all of specified disk area: 
/:DUMP BP 



This example specifies that all of the BP area is to be 
dumped onto the LO device. 



:XDMP The :XDMP command dumps the specified input 

onto the LO device (using the M:LO DCB) in hexadecimal 
and EBCDIC. The input is read and edited according to the 
device specified: cards for a card reader; sectors for a disk; 
blocks for a tape. 

The form of the command is 



:XDMP( 



yyndd 
.zz 
fid 
lop 



) [, (FILE, value )][, (FROM, value)] 



[. (TO, value)] 



where 



yyndd is an/ valid input device. 

. zz is a\y area. The period is necessary to dis- 
tinguish it as an area, not a file. 

fid is any allotted file. 

op is any oplabef which points to any of the 
above. 

FILE, value applies only to tape input devices and 
specifies the file in which the edit will start. 
:XDMP always assumes it is positioned at the be- 
ginning of file 1 and will skip value- 1 tape marks 
to position to the correct file. The default is 1. 

FROM, value specifies the number of the first rec- 
ord (card, sector or tape block within the speci- 
fied FlLE)tobe ^XDMPed. The default is for 
disk devices, 1 for all other 



TO, value specifies the number of the last record 
within the specified FILE to be tXDMPed. The de- 
fault depends on what is being :XDMPed: for o file 
it is EOT; for on area, EOA; tor a disk device, the 
last sector; for other devices, the 524,287th record . 

The processing of the TO parameter, whether specified or 
defaulted, depends on the FILE parameter. If a FILE number 
is specified, TO refers to records within that file only, and 
:XDMP will not process records beyond the tope mark (EOF) 
for that file (that is, the maximum value of TO is forced to 
the number of records In the specified file). 

Wien FILE is not specified, TO specifies the lost record to 
process, without regard to single tapemarks (EOFs). If 
double tapemarks (EOFs) are not found, TO-FROM+1 rec- 
ords will be :XDMPed. Processing will never go beyond 
double tapemarks. 



Examples: 
1. 



2. 



3. 



■ 



:XDMP 9TA80 



The tope on 9TA80 will be -.XDMPed from its current 
position to the double EOFs. 



:XDMP TO TO, 5 



The device or file addressed by op label TO will have 
the next 5 records JCDMPed. 



:XDMP TESTFILE.D3 TO, 10 FROM, 2 



File TESTFILE in area D3 will be :XDMPed from sector 2 
through 10. 






Y 



*DMP DPAF0TO,4 



Disk device DPAFO will have its first five sectors 
:XDMPed. 
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IMVE The sSAVE B oew mmd nvti the specified disk 
orao(>) on the BO device (using »he MAO OCB) far subse- 
quent restoration. The BO device Mutt be e magnetic-tape 
device. The image of the designated area(s) and the CP-R 
bootstrap are written on BO in self-reloadable format. The 
BO output contains a bootstrap loader, followed by tfe disk 
image of the CP-R bootstrap, and the designated oreo(i). 
Sectors containing all seres ore suppressed. Executing the 
bootstrap loader causes the disk image to be read into mem- 
ory and restored to the disic(s) without CP-R control . The 
bootstrap also types on TYAOI the dote that the save was 
made, and any identifying text string included in the 
:SAVE command. The BO output can also be used to restore 
the disk via the :RESTORE command. The BO device is re- 
wound and the data saved is verified. The message 

•SAVE TAPE OK' 

is output and the tape rewound off-line (unloaded) if the 
verification pass completes successfully. 

The form of the command is 



^:SAVE (fALL,]iz,«,...| [#t|op , ^ 



where 

ALL specifies all allocated areas except BT, CK, 
IS and OS. 

zz can be any disk area ■ 

'tape id' is a message of up to 40 characters to 

identify the save tape . When the tope bootstrap 
is executed this message will be output to the op- 
erators console (TYAOI). 

Examples: 

) . Save specified areas on secondary storage: 



.SAVE SP,BP,D2,'SAVE BACKGROUND PROGS-] 
■AND DATA' 



This example specifies that the SP, BP, and D2 areas, 
with a preceding bootstrap and an identifying text 
String, are to be saved on the BO device for subsequent 
re loading. 



This example specifies that all disk areas except BT, 
CK, IS or OS, with a preceding bootstrap, are to be 
saved on the BO device for subsequent reloading . 



{RESTORE The tRESTOf E command restores the specified 
permanent disk areas that were saved by the :SAVE com- 
mand.' input is rood from the Bl device (using the M:BI 
OCB), and the bootstrap is ignored. A CHKWRT is em- 
ployed to verify the data restored . 



The form of the command is 
/:RESTOREzz,zz,... 



Example: 



r 



RESTORE SP,BP,D2 



This example specifies that the areas SP, BP, and D2 (pre* 
viousty saved with a :SAVE directive) ore to be restored. 



SBOSECTOR The :BDSECTOR command specifies a group 
of sectors on a disk that are not to be used by RADEDIT. 
Sector of an area cannot be specified as it contains the 
first directory sector for thot area . 

The form of the command is 



r 



»_,,.__._- . . (number-numberirnumber-numberl 

:BDSECTOR yyndd-( number 



([number 



J"' 



Example: 



:BDSECTOR DPAFO, 300-3 11,401 



This example specifies thot RADEDIT use of sectors 300 
through 311 and sector 401 of the disk on DPAFO is to be 
inhibited. 



2. Save all areas on secondary storage: 
/:SAVE ALL 



RESTORE must be per fo rme d on the some device type from 
which SAVE wos performed, i.e., the device must have the 
Same sector size and same number of sectors per track . 
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ttOSECTOR Hm tGDSECTC* command specifies that 

Mcfon previously inhibited bruMb/a tIDSECTOR com- 
mandaretobe mode available for subsequent use. The disk 
and Melon must bo the now at in a previous iSDSECTOR. 



The fomi of the command it 



f 



number -n u mfaorlfn u ntbor -w u mb or l 



«.^^^~r^» m fnun^-n u nmonl n u mber ^ u mo or 
K5DSECTOR yyndd,[ nonter ^^ J... 



Example: 

/•GDSECTOR DPAFO, 401, 306-311 



This example specifies that the previously inhibited sectors 
306 through 311 and sector 401 are to be made available. 

:PF1L, :PREC, :REWIND, :SF1L, :UNLOAD, are identical to 
the corresponding JCP control commands (see Chapter 2), 
except for the leading colon. They permit tape position- 
ing to be done without leaving RAD ED IT. 



'END The :END command may be used to terminate the 
HADED IT processor. The form of the command is 



A 



END 



ERROR MESSAGES 

The error messages output by the RADEDIT and their mean- 
ings are given in Table 20. 

RADEDIT outputs error messages on the OC and LL de- 
vices. If OC and LL are assigned to the same device, 
duplication of messages on LL is suppressed. If on op- 
erator response is required, RADEDIT will call the "WAIT" 
routine. If the background is operating in the "attend" 
mode, the operator will be allowed to initiate a console 
interrupt and key in one of the following three commands: 

C continue and read next record from the C device. 

X abort RADEDIT and return control to the system. 

COC continue and read a record from the OC de- 
vice (used only in conjunction with the error 
message "ERROR ITEM xx"). 



Otherwise, RADEDIT will take the oction indicated in 
Table 20. 

If RADEDIT aborts because of an irrecoverable I/O error, 
the physical device name is included in the abort message. 



DISK RESTORATION MESSAGES 

The messages itemized in Table 21 are written on the 
keyboard/printer during disk restoration via the boot- 
strap loader produced by SAVE. Unless otherwise speci- 
fied, the computer will go into a WAIT after writing a 
message. 



Table 20. RADEDIT Error Messages 



Message 


Meaning 


Action Taken 


AREA xx CANNOT CONTAIN 
A RESIDENT FOREGROUND 
PROGRAM 


Illegal area specified. Only the FP area 
can contain a resident foreground 
program. 


Operation is aborted. 


AREA xx CKSM ERROR 


A checksum error exists an the SAVE tape 
in the specified area. 


Operation is aborted. 


AREA xx CONTAINS NO FILES 


Specified area contains no files. 


RADEDIT continues* 


AREA r.x INCOMPATIBILITY 


Attempting to restore specified area onto 
a different type of disk from which it was 
saved, or the area to be restored is too 
large for the some area using the current 
Master Directory. 


Operation is aborted. 
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Table 20. RADEDIT Error Message* (con t.! 


• 


Menage 


Meaning 


Action Taken 


AREA xx IS NOT ALLOCATED 


Specified area was nor al beared at 
SYSGEN. 


Operation is aborted . 


AREA xx DOES NOT CONTAIN 
A LIBRARY 


An area other than SP or FP was specified 
that does not contain a library. 


Operation Is aborted. 


AREA xx IS NOT MAINTAINED 
BY RADEDIT 


An attempt has been made to use area 
CK, XA, or BT which is not maintained 
by RADEDIT. 


Operation is aborted. 


AREA xx TRUNCATED 


Specified area being restored is larger 
than the same area using the current 
Master Directory, but the data that was 
lost contained all zeros. 


Operation continues. 


BUFFER SMALLER THAN DATA 
READ 


Data read exceeds the amount of avail- 
able buffer space. 


Operation is aborted . 


CKSM ERR ON SAVE TAPE 


A checksum error has been encountered 
while verifying the disk SAVE tape. 


Operation is aborted. 


CKSM ERROR 


Last record in the object module being 
read has a checksum error. 


If the operator response is C, RADEDIT 
reads the next record from the speci- 
fied device. 


DUPLICATE DEF xxxxxxxx 


Relocatable Object Module being 
copied to the library contains dupli- 
cate definitions. 


RADEDIT skips to the end of the mod- 
ule, A key-In of C causes RADEDIT 
to read the next record from the speci- 
fied device. 


DUPLICATE FILE 


An attempt has been made to allocate a 
file using a name which already exists. 


Operation is aborted . 


EOT on 


yyndd 
area, name 

(.area, name J 




Unexpected end-of-tape was encountered 
on the specified device or file. 


Operation is aborted . 


ERROR ITEM xx 


hem number xx on the command is in 
error. 


If the operator response is C, RADEDIT 
reads the next record from the C de- 
vice . If the operator response is COC, 
the next record is read from the OC 
device. This will enable operator to 
rectify a directive error. 


ILLEGAL BINARY RECORD 


An illegal binary record (first byte not 
X'lC, X'3C') has been read with an 
object module. 


If the operator response is C, the 
RADEDIT reads the next record from 
the specified device. 


ILLEGAL FILE NAME 


An attempt has been made to allocate a 
file using GO, OV, or X1-X9 as a file 
name. 


Operation is aborted. 


ILLEGAL LOAD ITEM xx 


Relocatable Object Module to the library 
contains an illegal load Item. 


RADEDIT skips to the end of the mod- 
ule. A key-in of C causes RADEDIT 
to rood the next record from the speci- 
fied device. 
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Tab!* 20. RADEDIT Error Messages (cont.) 



Message 


Meaning 


Action Taken 


ILLEGAL OPTION xxx 


Option specified i« not permitted on a 
jC OP /command. 


Operation is aborted . 


ILLEGAL USE OF .•COPY 


In* specified combination of Input and 
output devices on the :COPY command 
it prohibited. 


Operation is aborted . 


INVALID RSIZE. UNBLOCKED 
ORGANIZATION GIVEN 


Maximum record size for a blocked file 
has been exceeded. Unblocked organ- 
isation given. 


RADEDIT continues. 


NOT ENUF BCKG SPACE 


Insufficient background space to perform 
the requested operation. 


Operation is aborted . 


DISK OVERFLOW 


Allocating the amount of disk storage in- 
dicated by the "FSIZ" parameter on the 
:ALLOT command would exceed the 
•pace available in the area specified. 


Operation is aborted . 


RADEDIT I/O ERROR xx 
ATLOCkxxx 


An I/O error has occurred at the indicated 
location. 


Operation is aborted . 


WARNING: RECORD SIZES 
DIFFER ON INPUT AND 
OUTPUT FILES 


Record sizes differ on copying from disk 
file to disk file. 


Operation is continued . 


REFERENCES TO F4:COM NOT 
ALLOWED 


An external definition or reference 
F4:COM encountered in a Relocatable 
Object Module being copied to the 
library. 


RADEDIT skips to the end of the mod- 
ule. A key-in of C causes RADEDIT 
to read the next record from the speci- 
fied device. 


ROM DOES NOT CONTAIN 
ADEF 


Relocatable Object Module being copied 
does not contain an external definition. 


A key-in of C causes RADEDIT to 
read the next record from the speci- 
fied device. 


SAVE TAPE OK 


Disk SAVE tape has been verified 
correctly. 


No action . 


SEQ ERROR 


Last record in the object module being 
read has a sequence error. 


If the operator response is C, RADEDIT 
reads the next record from the speci- 
fied device. 


FILE jooooootx DOES NOT 
EXIST 


File does not exist in the specified area 
or account . 


RADEDIT continues. 


SPECIFIED ROM DOES NOT 
EXIST 


Relocatable Object Module does not 
exist within the specified library. 


Operation Is aborted . 


SREC VALUE GREATER THAN 
EREC VALUE 


Parameter error on the sDUMP command. 
The last record to be dumped precedes 
the initial record to be dumped. 


Operation is aborted • 


AREA xx NOT FOUND ON 
SAVE TAPE 


Specified area cannot be found on the 
disk SAVE tape during a rRESTORE 
operation. 


Operation It continued. 


ABOVE AREAS NOT 
RESTORED 


The areas specified by the preceding mes- 
sages were not on the SAVE tape . 


RADEDIT aborts. 
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Table 20. RADEDTT Error Messages (cent.) 



MMMQC 


Meaning 


Action Taken 


DATA IN SECTOR xxxxx 
[TO SECTOR xxxxx] MAY BE 
LOST IN AREA zz 


The indicated sector(s) reported errors 
when being read from the disk . The 
data may not be correct on the SAVE 
tope. W«en the area is JtESTORED, 
these sectors should be Inspected for 
the repeated string 'LOSTDATA' 
which was used to replace the data 
not read. 


Operation continues. 


WARNING: ERRORS WRITING 
SAVETAPE. CHECK LISTING. 


Self-explanatory . 


Operation continues. 


FILE xxxxxxxx DELETED 


The beginning of the named file is 
- included in the bad sector(s) and was 
deleted from the directory. 


Operation continues. 


FILE xxxxxxxx TRUNCATED 


The end of the named file is included 
in the bad sector(s) range, and was 
truncated at the last good sector. 


Operation continues. 


yyndd WRT RESTRICTED 


Specified disk is software write-protected. 


Operator should toke appropriate ac- 
tion: interrupt and key in "SYC". Or, 
if the job is not allowed to write on 
protected areas of the disk, interrupt 
and key in "X " to abort . 



Table 21. Disk Restoration Messoges 



Message 


Meaning 


Resulting Action 


CKSM ERROR 


A checksum error has occurred in reading 
the SAVE tape. 


If the WAIT condition is cleared, the 
bootstrap loader continues and accepts 
the bad record. 


DISK RESTORED OK 


The disk restoration has been successfully 
completed. 


Control is transferred from the disk 
bootstrap. 


TRK = xxxx 

DATA = ALL ZEROS 


Specifies the contents of the disk control- 
ler address register in hexadecimal at the 
time of a check write error. 


If the data being written contains all 
zeros, this information is output. If 
the WAIT condition is cleared, the 
bootstrap loader continues. * 


yyndd ERROR, 

SB = xxxx 


A parity or transmission error has occur- 
red on device yyndd. Both the device 
status byte and operational status byte are 
displayed following "SB=". 


There is no recovery. 
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TabU 2). Disk Restoration 



(cent.) 



MeMMQt 


AMOftinQ 


Resulting Action 


yyndd UN RECOG., 
SB s xxxx 


An unrecognized ttatut has been returned 
from the Indicated device. Both the de- 
vice ttatut byte and operational status byte 
are displayed following "SB=". 


Upon clearing the WAIT condition, 
the operation is retried. 


yyndd UNUS. END, 
TDV = joooc 


An unusual end ttatut hat been returned 
from the specified device. Both the TDV 
status byte and operational status byte 
are displayed following "SB=". 


There is no recovery on a read opera- 
tion. On a write operation, the write 
is tried again after the WAIT it cleared. 


yyndd WRT PROT 


The disk is write-protected. 


ftogrom will attempt the disk write 
after an SY key-in. 
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12. PREPARING THE PR06RAM DECK 



The following examples >how tome of the ways progiom 
decks may be prepared for CP-R operation. Unless stated 
otherwise, standard default eases for device assignments 
are assumed. 



AP EXAMPLES 

ASSEMBLE SOURCE PROGRAM. LISTING OUTPUT 

I Next Command 

/ 



Source Deck 



Q 



|APSl,LO 



UOB 



y 



In this example, the symbolic input is received from the SI 
device and the listing output is produced on the LO device. 



ASSEMBLE SOURCE PROGRAM. LISTING OUTPUT. 
LOAD AND GO OPERATIONS 



|Soui 



| ! PMD 



| !ROV 



IOLOAD (MAP,PROGRAM),GO 



| Source Deck 
llAPSl,LO,Go" 




I JOB 



In this example, the binary object program produced from 
the assembly is placed in a temporary (GO) file from which 
it is later loaded and executed. The resultant file is always 
temporary and cannot be retained from one fob to another. 
The Overlay Loader loads the program root into the OVfile 
for execution. A postmortem dump is specified. 



ASSEMBLE AND LOAD A PROGRAM WRITTEN FOR UNMAPPEr 
(RBM) BACKGROUND EXECUTION 



||RQV 
)IPMD 



(sou 



j SOURCE DECK 
||APS1,LQ,GQ 



| IOLOAD (MAP.PROGRAM^GO.SM /vO 



UOB 



This example is like the previous one, except that the pro- 
gram either uses SEGLOAD calls, or uses memory outside its 
segments. The SMM (Simplified Memory Management) op- 
tion on the IOLOAD command couses the program to be 
loaded in a manner that allows these actions, but can result 
in much less efficient real memory utilization. 

ASSEMBLE FROM COMPRESSED DECK WITH SOURCE 
AND UPDATES. LISTING OUTPUT 



{Corm 



Compressed Deck 



MMMMMMMMMltft. 



+END 



£ 



1 



<* 



■pTT? 



Symbolic Update 



0, 



Symbolic Update 



B. 



jSyTiib 




Update 
Deck 



y 



+5 



Symbolic Update 




|lAPSI,Cl,LO,LU 



UOB 



\*y 



In this example, the compressed input (deck) is received from 
the CI device, listing output is produced on the LO device, 
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lilting of the update deck h alto produced on Mm LO 
ice. The update dock is enclosed in the bracket. 



ASSEMBLE SOURCE PROGRAM. COMPRESSED 
OUTPUT ON CARDS. LISTING OUTPUT 



I Sou 



| Next Common d 



_ Source Deck 
JlAPSl,CO,LO 



Si 



I JOB 



In this example, the compressed card output is produced on 
the CO device. 



ASSEMBLE SOURCE OR COMPRESSED PR06RAM IN 
RATCH MODE. LISTING OUTPUT 



ZL 



IEOD 
|lEOD 



Source or Compressed Input 



^ 



IEOD (optional) 



Source or Compressed Input 



<^ 



IEOD (optional) 



£ 

|So> 



1 



ource or Compressed Input 



-j 1APSI (or CI), LP, BA 



(JOB 



Whan batch aseembliet consist of successive updates from 
card input Jo compressed progra ms from disk or tape, the 
updates are terminated by a +END card and should not be 
separated by IEOD cards. There must be a one-to-one 
correspondence of update packets to compressed programs. 
End-of-job is signaled by end-of-file conventions applied 
to the CI device. 



ASSEMBLE SOURCE PROGRAM. COMPRESSED 
OUTPUT ON DISK Flit LISTING OUTPUT 



fso3 



Source Deck 
| IAPSI,LO,CO 



Si 



I ASSIGN (M:CO,Dl, COMPRESS) 



f:(RS!ZE,30) 



A 



| :(FORMAT,B), (FSIZE, 300), ; " 
\ -.ALLOT (F1LE,DI,CQMPRESS),; " 
— | I RAPE PIT "*" 

I JOB X 



In this example, the CO device is assigned to a disk file 
called COMPRESS in a background data area of the disk. 
The compressed output is written on the COMPRESS file. 



ASSEMBLE COMPRESSED DECK FROM DISK FILE. SOURCE 
UPDATES FROM CARDS. LISTING OUTPUT 



fc 



+ END 



Update Deck (+ Cards an 
|lAPSl,Cl,LO 



d Source) \/ 



1 1 ASSIGN (M:C1.D1. COMPRESS) 
I JOB \ 



In this example, successive assemblies are performed with 
a single AP command until a double EOD is read. The de- 
vice assignments and options on the AP command apply to 
all assemblies within the batch. A program is considered 
terminated when an END directive is processed. 



In this example, the CI (compressed input) device is as- 
signed to the COMPRESS file in a background data area of 
the disk. The source update deck will be read from the SI 
device. In effect, this will update the assembly given in the 
previous example. 
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ASSEMBLE SOUSCE PROGRAM, WRITE COMPRESSED 
OUTPUT 01 O-TRACK TAPE, USTM6 OUTPUT 



ASSEMSLE COMPRESSED PROGRAM FROM 
O-TRACK TAPE. USTIN6 OUTPUT 



[Souri 



J Source Deck 
|IAPSI,CQ,LQ 



IREW9TA83 

I1ASSIGN (M:CO,9TA63r 



ft 




y 



|lAPCl,LO 
1 1REW9TA83 



| IASSIGN (M:C1,9TA83) 



I JOB 



In this example, the CO device is assigned to the designated 
9-track magnetic tape unit to receive the compressed output. 



in this example, the CI device is assigned to the desig- 
nated magnetic tape to read the compressed input to be 
ossembled. This is the next logical job step to follow 
the previous example. 
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r fORTRANJOBEXAMPlES 

COMIMED FORTMR COHMUTDM. PUIS FORTRAN COMPILE AMD EXECUTE 



( 



I Dot, 



llFIN 

llEOD 



.Dot o Deck 
|lROV 




|!OLOAD(MAP,ALL),GO 
llEOD 

4. f FORTRAN Source Deck S|^A 

[lFQRTRANLO,GO 



!EOD 



£ 

|FOf 



2l 



MMMtapltaHiriM 



£ 



3. 1 FORTRAN Source Deck 
| I FORTRAN LS 
HlEOD 



O 



I. |FOR 



2. 1 FORTRAN Source Deck 
l IEOD 



<5i 



\ 



1.|FORTRAN So urce Deck 
llFORTRANLQ 



% 




J 



f 



In this example, the first two source decks are compiled with mixed (source and object language) listed output. The next 
source program (3) is compiled with a source listing (only) being output. The final source deck (4) will compile with the ob- 
ject module being output on both the BO and GO files. The Loader inputs the object module from the GO file to form the 
Root and outputs the executable program to the OV file. The program (called OV) is executed via the IROV command. 
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compile md mam nmuM somce pmcram with realtime lmkmes 



I Dote 



| 1F1N 



Z 



|Dato Deck 

|lROV 

1 10LOAD GO, (MAP, ALU* 




I FORTRAN Source Deck 
('.FORTRAN Sl,LS,BO,GO,RT 

IASS1GN (MrBO,BP, BOFORT) 



<> 



|:(FORMAT,B),(RSIZE, 30), (F SIZE, 50) 
ItALLOT (FILE, BP, BOFORT); 
JjRADEDIT X 




y 



In this example, RADED1T allots a file called BOFORT in binary format to the Background Program area of the disk. 
The specified record size is 30 words; the file size is 50 records. The {ASSIGN command assigns the M; BO DCB (binary 
output) to file BOFORT. The IFORTRAN command specifies that symbolic input is to be read from the SI device, the source 
input is to be listed (LS would be redundant if LO was specified in addition to IS), and the binary output is to be written out 
on both the BO and GO files. The relocatable binary output on the file "BOFORT" may be used as input to the Overlay 
Loader at a later date. Since the real-time option (RT) is specified, the linkage will be set up for real-time subroutines. The 
Overlay Loader (lOLOAD) reads input from the GO file, outputs an ALL map, searches the System Library (by default), and 
writes the executable program into the OV file. The program is run via the IROV (Run OV) command. Note that a program 
with real-time linkages can also run in the background in nonreal-time mode. 
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( 



«0MM1£ M» BSOTE PMMMM HtM6 IS. M KMMT tfTlOW 



I Dot 



|1F1N 



mtmmm*mm 



_ Data Deck 

jlROV 

| :ROOT (FILE, BP, BOFORT) 
|!OLOAD(MAP.ALL) 




IEOD 



£ 



FORTRAN Source Deck 



<> 



_! FORTRAN 

pASSIGN (M:BO,BP, BOFORT)"" 

|:(FORMAT > B),(RSIZE,30) > (FSIZE,5^' 

| : ALLOT (FILE, BP, BOFORT); 

JjRADEDIT 




In this example, the LS (list source) and BO (binary output) ore assumed by default on the IFORTRAN command. The Syster 
Library is searched via the default option on the lOLOAD command. 
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*- 



compiu a mmiM n»6iuM mo sew nt executim ■ foreground area 



4 

Jfoi 



| If 1M 

jlROV 
|:(MAP,AIL),(F ORE ,6000) 
| iOLOAD (GO),(TEMP,6Q0) ; 
llEOD 



ORTRAN Source Deck 



^ 



! FORTRAN LS,GO 



1 1 PAUSE KCY-1NPGC 
1 1 ATTEND 



!JOB 12345, D 



y 



In this example, the ! ATTEND command will inhibit the system ABORT routine *o that corrective action can be taken at the 
console in case of error. The FORE option on the IOLOAD commond gives the FWA of the program in the Foreground area of 
memory. 
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4VERLAY LOADER EXAMPLES 

4ATCH. t*IIC M 1MB 



jlROV 
| IPMD 
I lOLOAD (GO,LlNKS),MAP 

[FORTRAN Source Deck \jt 



FORTRAN Source Deck 
I ! FORTRAN SI, GO, LP, LS 



FORTRAN Source Deck 



! FORTRAN SI, GO, LO.LS 



£ 



FORTRAN Source Deck 



(FORTRAN SI, GO, LO,LS 



I 




ROV 



| IPMD 



£ 



1 :VFC,(RECl, 133) 

| :ASSIGN (F:2,LPA02),BCD; 
| lOLOAD GO,(UDCB,l),MAP 



FORTRAN Source Deck 
1 1 FORTRAN SI, GO, LP, lT" 



<> 



1JOB 



In this example, the GO file is rewound by the initial I JOB command for the first FORTRAN compilation. The Overlay Loader 
loads from the GO file to form a root and outputs on the OV file for execution. A SHORT mop will be output. A postmortem 
dump is requested if the background aborts. The next I JOB command rewinds the GO file and three FORTRAN jobs are com- 
piled, with the binary object modules output on GO to form ROMl,ROM2,ROM3. The Overlay Loader loads the first ROM 
for the root, the second ROM for segment 1, and the third ROM for segment 2. Note that :SEG cards are not required. The 
programs are executed from the OV file. A SHORT map it output. A postmortem dump is specified in casein abort occurs. 
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ttB M U ntP 1ACRBMMNU JOB 



£ 



]tRUN(BP f CALCLOAD)' 
| :(FILE,D5,CALC3) 
| :SEG (UNK,3,ONTO,0); 
| ;(FILE,D5,CALC2) 

| tSEG (UNK t 2,ONTO,0); 
I ! EOD " 



nory Object Module 



binary Object Module 




Binary Object Module 
| :(DEV1CE > CRA03,EOD) 



■|:SEG (LINK, 1, ONTO, 0);' 



| :ROOT 
j :CALCLOAD) 




In this example, the JOB card rewinds the GO file, the FORTRAN source deck is compiled, and the binary object module 
is output on GO. The compressed source deck is updated and the binary object module is output to file CALC2 in the 
D5 area (previously allocated by RADEDIT). The ROMs designated on the :ROOT end :SEG commands are loaded, and 
the loaded program is output to CALCLOAD in the BP area. The :ROOT command causes the ROM created by FORTRAN 
to be loaded from the GO file and creates the Root. The ROMs following the first :SEG command ore looded until I EOD is 
encountered and segment 1 is then created. The next :SEG command loads the ROM assembled by Macro-Symbol on the 
CALC2 file in the D5 area and creates segment 2. The last :SEG command loads one ROM from the CALC3 file in the D5 area 
(ROM previously created by an assembly or compilation). The I RUN command executes the loaded segmented progrom. 



192 Overlay Loader Exempli 



es 



FOREGROUND JOB EXAMPLES 

LOAD AMD EXECUTE FOREGROUND PROGRAM 



fJFlN 



fih 



| |RUN(FP,FINT) 



nory Object Deck 



:ROOT (ENTRY,INIT),(DE VICE.CRA03) 
| :(F1LE,FP,F1NT),(MAP,PR0GRAM) 



<^ 



!OLOADFORE,PRl; 



| :ALLOT (FILE,FP,FINT),(FSIZE,25) 
IRADEDIT ^ 



1MESSAGE LOADING FG TEST JOB 
| .'ATTEND "~ \ 

! PAUSE KEY-IN FSC \ 



UOB 



In this example, RADEDIT allots a file, (F1NT) in the Foreground Programs (FP) area of the disk. The Overlay Loader loads 
the binary object deck in the file F1NT in core image format. The I RUN control command causes execution of the foreground 
program as a primary task (PRI on OLOAD command) in the CPR job. A PROGRAM map is specified. 
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UAO MD EXECUTE KSMOTEO F0HE6MUID FftOGRAM 



I 



!FIN 



M 

[Birv 



| IRUN(FP,FSEG) 



| Bin. 



inory Object Deck 

1 :(EXLOC,7C00),(DEV,CRA03) 
| :SEG (LINK 2,ONTO,0); 



^ 



inory Object Deck 

| :(EXLOC,7A00),(DEV,CRA03) 
j :SEG (LINK 1,ONTO,0) ; 



<* 



Binary Object Deck 




\ ;(DEV,CRA03) 
| :ROOT (ENTRY.OVFQR); 

|:(FILE,FP,FSEG),(MAP,A~ 
■{ IQLOAD (FORE), (PR1); 



|:ALLOT (FILE,FP,FSEG),(FS1Z£,25) X 
IRADEDIT ^ ^ 

| 1 MESSAGE LOADING FG TEST JO B 
| IATTEND N 

J '.PAUSE KEY-IN SFC 




In this example, RADEDIT allots space for a file called FSEG in the Foreground Program (FP) area of the disk. The Overlay 
Loader loads a root and two segments into FSEG in core image format. The overlaid program is executed (as a primary task) 
via the (RUN control command. An ALL map is requested. 
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LOAD TWO FOftEGROOU SECONDARY PROGRAMS tHAJUK A REAO-ANO-GSCUTE PROCEDURE 



l:(SHA.JOB),(ACC,RX),(EXLOC,A00Q) 
1 ;SEG (LIN, 1),(F1L,D1,CURVEFIT): 
_L:ROOT(FIL,Dl,FP2BI) 



| IOLOADMAP,FQRE,SEC,(FlLE,FP,FP2) 

I ;(SHARE, JOB), (ACCESS ,RX),(EXL PC ,A0O0J 

1 ;SEG (LINK,1),(FIL,D1,CURVEF1T); ' 

1 ;ROOT(FlL,D1,FPlBI) ' 

1 IOLOADMAP,FQRE, SEC, (FILE, FP,FP1) 




This example causes two foreground secondary programs to be loaded. All object code comes from files in the D1 area, 
presumed to be generated by past assemblies/compilotions. Both programs load the same object code as segment number 1 
(FIL,D1,CURVEFIT). This segment is restricted to read-and-execute access (ACCESS, RX). If the programs both run in the 
same job, and concurrently activate the segment, the some copy of the segment (i.e. , the same memory map for the virtual 
memory concerned) will be mode available to both programs (SHARE, JOB). 



LOAD FOREGROUND SECONDARY PROGRAM WITH A SEGMENT FIXED IN REAL MEMORY 



1 ;(EXLOC, 10000), FIX 



:SEG (LINK,1),(F1L,D1,FP3SEGB1): 



:ROOT (FIL,D1,FP3BI) 



| lOLOAD MAP, FORE, SEC, (F1L,FP,Fp1? 



IJOB 



Segment 1 is defined with the FIX option. This forces it to be allocated real poges so that the real address of any location in 
the segment is the same as its virtual address. Note that the real pages must lie in a foreground preferred memory partition, 
and must not be assigned for other use. 
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1MB PM6RAM Win BYMAMtCAllY-ALLOCATED KSMEMT 



| ;RES (SPACE, 4096) 
| tSEG (LINK, 1), NONE 



iROOT (DEVICE.9TA81,EOD) 




In this example, a foreground secondary program Is loaded into file FP4 in the FP area. The object code for the root is obtained 
from tope drive 9TA81, up to the first tape mark. Segment 1 is composed of no object code; but a OSECT of size 4096 words 
is reserved, and is identified by the symbol 'SPACE 1 . Since the size of the segment is entirely due to the ;RES command, its 
load module image has length zero. This means that the segment may be the subject of GETPAGE and RELPAGE CAU, which 
dynamically alter the part of the segment for which real memory Is allocated. 
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U LINE EDITOR (EDIT) 



MTRODUCTON 

CP-R Edit it a line-at-o-time editor for on-line or batch 
creation, modification, and manipulation of file* of EBCDIC 
text. Edit functions ore controlled by a stream of single- 
line commands read through the M:S1 DCB. The command 
language provides for the following types of operation: 

1. Creating a sequenced EBCDIC file. 

3. Selective printing of lines or partial lines of a file. 

3. Inserting, reordering, and deleting of lines or groups 
of lines in a file. 

4. Editing the content of lines or groups of tines, includ- 
ing character string insertion, replacement, shifting, 
and deletion. 

5. Resequencing or reordering by sequence number of 
whole files. 

6. Merging parts of several files, when assisted by cer- 
tain RAD EDIT functions. 

Use of Edit involves two files. The subject file is the 
source of the data to be edited, but is not directly affected 
by editing. The scratch file is built from the subject file 
when editing is begun. It is an indexed direct-access disk 
file containing all of the information from the subject file, 
indexed by sequence number. All editing is done on the 
scratch file. The subject file may be rebuilt from the 
scratch file at certain well defined times in the editing 
session, or the session may be terminated without altering 
the subject file. 



CALLING EDIT 

Edit is called by being named in either the batch control 
stream or a TEL control stream 

EDIT 



SUBJECT FILE FORMAT 

An Edit subject file is a file of EBCDIC dato in fixed or 
variable length records of not more than 140 characters. 
It may be compressed, blocked, or unblocked. Each record 
is treated as one line of text. 

A line sequence number may be specified in the lost eight 
bytes of a record. If these sequence numbers are to be used 
by Edit, they must appear in the last eight bytes of every 
record. The records need not be in sequence number order 
and more' than one record may have the same sequence 



number. Only the lost record with a given sequence 
number will be retained by Edit, if it \nm sequence num- 
bers from the subject file. 



SEQUENCE NUMBERS 

A sequence number is a positive decimal number which is 
less than 10000 and a multiple of .001 (i.e., no more than 
three decimal places). When specified in a subject file 
record, a sequence number occupies the last eight bytes of 
the record. It may include a decimal point, decimal digits, 
and leading and trailing blanks, but must include at least 
one digit. Special processing of sequence numbers is exe- 
cuted if the save file sequence mode is set: When the Edit 
scratch file is built, if o record has a valid sequence num- 
ber in its last eight bytes, it is removed. When the scratch 
file is saved, the last eight bytes of each saved record will 
be its sequence number. For fixed-length records, the last 
eight bytes will be overwritten by the sequence number. 
For variable length records up to 132 bytes, the record 
will be extended by the eight bytes. If the record is over 
132 bytes already, bytes 133-140 will be the sequence 
number. 



FILE IDENTIFIERS 

In the commands involving a file identifier (EDIT and 
SAVE) the standard CP-R file identifier is used, with the 
restriction that it may not be of the 'area, name' format. 



INPUT/OUTPUT CONVENTIONS 

The input/output conventions used in Edit are independent 
of whether execution is batch or on-line. Commands are 
read through M:SI and logged through M:LL if it is assigned 
to a different device than M:SI. Error messages and com- 
mand prompting will be written through M:LL always. Out- 
put other than error messages, command prompting, and 
command logging will go through M:LO.*»The results ore: 

1 . The c omman d source need not be a user's console. 

2. The medium assigned to M:LL will contain a complete, 
non-redundant log of control activity. 

3. If M:LO is assigned differently from M:LL, it will 
receive text output free of any control messages. 



Line Editor (Edit) 197 



MULTILINE RECORDS 

On a terminal unit having an Inherent Una-width limit af 
less than 140 (e.g.. Teletype models 33, 35, and 37), a 
single, multiline record may be entered into a file (using 
the IN command, for example) in either of two ways: 

1. Using the local carriage return key marked LOC CR, 
if present, to "break" the input line without releasing 
it to the system. 

2. Using the simulated local carriage return sequence 
©©for the same purpose. 

Either method permits entering a record of up to 139 char- 
acters plus © on virtually any terminal unit. 

An example of a multiline record is presented in Figure 27. 



BREAK FUNCTION 

The BREAK key always causes an immediate interruption in 
Edit activity, with any partially completed input being dis- 
carded and any waiting output being delivered to the ter- 
minal. Edit stops any command in progress and reverts to 
accepting command input from the user. 

If the command in progress when an interrupt occurs is a 
display command (for example, TY), the display will stop 
within the next several lines after the interrupt is given. 

For commands that produce no display while operating on a 
range of records, the point of interrupt is reported by a 
messoge which denotes the sequence number(s) of the rec- 
ord^) being processed at the time of the interrupt. Edit 
then types this message 

—X TO ABORT 

and prompts for a single character input. If the user enters 
an X, the operation aborts; if he enters any other char- 
acter, the operation continues. 



If a command it being executed and the Break key causes 
an interrupt during an I/O operation (e.g., READ, WRITE, 
OPEN, DELETE record), the J/O operation is completed. 
After the I/O is completed, the user may continue exe- 
cution of the comrwnd to normal conclusion or may immedi- 
ately abort the command. With record or intrarecord com- 
mands (see Command Structure), the current Edit file re- 
mains open. If a file command is aborted, all files in use 
are closed. 



ERROR RESPONSE 

I/O errors other than EOF encounter cause Edit to abort. 
EOF on the M:SI DCB cause Edit to execute an END com- 
mand. Other errors generally result in a message. In 
batch execution, a WAIT will then be executed (which 
results in an abort if unattended batch mode is in effect), 
followed by reading another command, in on-line execu- 
tion, the WAIT is omitted. 
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COMMAND STRUCTURE 

Edit commands fall into the following three categories: 

1. File comma n d s : Commands that apply to an entire fi 1 1 
These commands may be given at any time. 

2. Record commands: Commands that act upon one record 
or a group of records within a file. These commands 
may be given only after a file has been selected for 
editing. 

3. Intrarecord commands: Command s that make changes 
within an individual record. These commands gen- 
erally manipulate character strings and may be given 
only after a specific set of records has been selected 
by a command of type 2, above (either the SE, SS, or 
ST command). 



Line number 4. 000 is input as a multiline record in the following manner: 

4.000 THIS IS AN EXAMPLE OF A MULTILINE ©@ 
RECORD. A RECORD CAN CONTAIN UP TO 140©© 
CHARACTERS INCLUDING THE CARRIAGE RETURN.© 

If this record were displayed by Edit, it would appear as 



4.000 THIS IS AN EXAMPLE OF A MULTILINERECORD . A RECORD CAN CONTAIN U 
P TO 140 CHARACTERS INCLUDING THE CARRIAGE RETURN. 



Note that the user did not type a space after the word 'multiline 1 and that Edit did not assume a space. Also, 
the system "folds" the record indiscriminately when the physical line width limit is reached. 



Figure 27. A Multiline Record 
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FH1 COMMANDS 

TIm file commands will be discussed in the following order: 

EDIT Soloct fil* lor Siting. 

SAVE Sov* Iho edited data. 

END Exit to executive. 

SEQ Sot tavo Fil* toquoncing mode. 

BP Sot blank preservation mode. 



EDIT Select a File for Editing 

The EDIT command initiates editing on a new file. Its 
format is: 



E DIT fid 1 OVER fid2 [, start [, step]] 



or 



EDIT fid2 



where 

fidl is the file identifier for the subject file, and 
fid2 is the file identifier for the scratch file. 

On receiving this command, Edit will first determine if there 
is an edit operation already in progress. If there is, the old 
subject file will be rebuilt from the old scratch file and both 
files will be closed. Then, the new scratch file will be built 
from the new subject file. The sequence numbers for the 
lines of the file are determined by the "start" and "step" 
parameters. The default value for each is 1. If either is 
specified, the sequence number will start with "start" and be 
incremented by "step" for each record. If neither is speci- 
fied. Edit examines the fast eight bytes of the first record of 
the file. If this is a sequence number, the sequence number 
for each record will be determined by its last eight bytes, 
and an error will be reported if any record does not hove a 
valid sequence number there. If the first record does not 
end with a sequence number, "start" and "step" of 1 will be 
used. If the second form is used, "fid2" must identify a pre- 
viously-built scratch file or an empty file. The subject file 
is not defined. 

If line numbers are taken from the subject file, and are not 
in order, they will still be indexed correctly. If more than 
one line has the same number, only the last one a used. 
When the temporary file is finally saved, records ore writ- 
ten in line number order. However the sequence numbering 
is determined, if the save file sequencing mode is on, any 
record containing a valid sequence number in its last eight 
bytes will have these bytes truncated. 



SAVE 



Save the Scratch File 



The SAVE command allows the user to explicitly request 
that the data in the scratch file be saved. Its format is: 



SAVE 



[S>] 



If no options appear, the subject file (if it is defined) is 
rebuilt. If the "fid" (file identifier) parameter appears, the 
identified file is built. If "ON" appears, the file "fid" must 
not exist, and will be allocated. If "OVER" appears, "fid" 
will be allocated if necessary. If "fid" must be allocated, 
it will have the same structure as the subject file, with ade- 
quate size. If the file on which the save is made is estimated 
to be too small, two behaviors are possible: If "fid" was not 
specified, an error results, but the subject file is unchanged. 
If "fid" is specified, the save operation is attempted. In the 
the case of o compressed save file, the estimate is intention- 
ally high so the sove operation may succeed. Ifthe save does 
not fit, an error results. 



END 



Terminate Edit Control 



The END command causes Edit to close its files and release 
control. By default, Edit will rebuild the subject file from 
the scratch file at this time, if the subject file is defined. 
A keyword on the END command overrides this. The com- 
mand format is: 

END[NSj 

If "NS" appears, the scratch file will not be saved over the 
subject file. If "NS" does not appear, but the subject file 
is estimated to be too small for a complete save, an error 
results and the subject file is unchanged. 



SEQ 



Set Save File Sequencing Mode 



The SEQ command sets the save file sequencing mode on or 
off. The SEQ command has the following format: 



ISEQJ° N 1 



off) 



When "ON", a save operation (resulting from an EDIT, 
SAVE, or END command) will result in the sequence num- 
ber of each record being written in its last eight bytes. An 
EDIT command will result in truncation of the last eight 
bytes of any record which contains a valid sequence number 
there. When "OFF", all records are acquired and saved 
without alteration. The initial mode is "ON". 



IP Set Blank Preservation Mode 

BP sets the blank preservation mode ON or OFF. 
command has the format shown below. 



TheBP 



:»[ra] 



When"ON", all strings of blanks are preserved during intra- 
record operations. When "OFF", blank* strings ore compressed 
to a single blank or expanded as required to retain column 
alignment of nonblank fields. The default mode is "OFF". 

When a string is inserted or replaced in a manner that 
changes the number of characters in a record, the record 
format is adjusted as follows. 
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When "ON" ,ofl ctrlngi of blanks ore preserved during Intro- 
record operations. When "OFF", blank strings an* compressed 
to a single blank or expanded as requited to retain column 
alignment of nonblank Fields. The default mode is "OFF". 

When a string is inserted or replaced in a manner that 
changes the number of characters in a record, the record 
format is adjusted as follows. 

When the blank preservation mode is off, the blanks be- 
tween two successive strings are not preserved. When a 
string operation causes the first of two strings to be ex- 
panded or contracted, the number of blanks between the two 
strings are decreased or increased so that the second string 
stays in the some columnar position. (If the first string 
expands, the number of blanks between the two strings de- 
creases; if the first string contracts , the number of blanks 
increases.) At least one blank must be left between strings. 

When the blank preservation mode is on, the blanks be- 
tween the two strings are preserved. That is, when the first 
string expands or contracts, the second string is moved to 
the left or right so that the some number of blanks remains 
between the two strings. 

For example, the following string substitution command 

VB/SAINK/® 

substitutes the string "LINK" for the string "8" in the 
instruction 

$10 BAL,8 SUB 

adjusting blanks as indicated below: 



old 

new (BP-OFF) 

new (BP-ON) 



$10 BAL,8 SUB 
$10BAL,LINK SUB 
$10 BAL,UNK SUB 



Although the BP command is discussed with the file commands, 
it may also be used when Edit is in the record mode. 



60 ni RET 



COMMAND STREAM CONTROL 



Orange the Source of Commands 



These commands allow the execution of a program of Edit 
commands from the file being edited. Additionally, RET 
allows conditional premature termination of a line of Edit 
commands being applied to a range of lines. The formats 
are 



GO 
RET 



where 



is a line sequence number. 



GO causes Edit c o mmands to be obtained by read- 
ing the edited file sequentially, beginning with 
the first line whose sequence number is greater 
than or equal to "s". 

RET causes immediate return of control to M:SI, 
so may be used to break out of either GO mode, 
or of executing inrrarecord co mma nds on a range 
of lines. 



These c o m mands may not be used in step mode, but may be 
used In either record or Intrarecord mode. IT an inrrarecord 
range Is In effect, these commands do not change it. If they 
are conditionally specified in a line of commands acting on 
a range of records, the execution of the line of commands 
will be terminated whenever GO or RET ir executed, even 
if there are mora records in the range. 

Execution of commands from the file being edited termi- 
nates on 

- execution of RET; or 

- executing to the end of the edited file; or 

- an error in syntax or execution; or 

- BREAK signal, followed by an "X" keyin. 



Control then returns to M:SI. 



Example of executing from the edited file: 
•TY 1-9999 list the file 

1.000 A 

2.000 BX 

3.000 CXX 

4.000 D 
9000. 000 SE 9 1 00-9200; 1 P/DE/ 
9100.000 2 
9101.000 4 



9500.000 RET 
•GO 9000© 

SE 9100-9200; 1P/DE/ 
2 STRINGS CHANGED 



DE2 

* 

DE4 

* 



execute commands from 
it 



edit commands to exe- 
cute next 



execute commands [ust 
built 
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RET 




-™ 


1-10 




1.000 A 


3.000 CXX 



return control Id M&I 
list results 



Example of premature termination of intrareeard processing 
on a range of records: 



•SE 


1-5 -b 




•TV 


(.,-, 








1.000 


A 






2.000 


BX 






3.000 


CXX 






4.000 


D 




• 


IP/2/; 2/X/Y; 


RET^ 




3 STRINGS CHANCED 


•TY 


i. 








1.000 


ZA 






2.000 


ZBX 






3.000 


zcxx 






4.000 


D 





RECORD EDITING COMMANDS 

The record editing commands may only be given after a file 
has been selected for editing vio the EDIT command. If the 
user does not select a file for editing before giving a rec- 
ord editing command. Edit prints the message: 

-NO FILE NAMED 

The record editing commands will be discussed in the fol- 
lowing order: 

•r I Insert records. 

DE Delete records. 

TY 

TC Type individual records. 

TS 



MD1 
MKJ 

FD 



FT 

FS 

RN 
CM 
SE 

SS 



Reorder records within a file. 

Delete records containing a specified char- 
acter string. 

List sequence numbers and contents of records 
containing a specified character string. 

List sequence numbers of records containing a 
specified character string. 

Renumber record. 

Insert commentary. 

Select a group of records for character 
operations. 



s _ I Select records for step mode operation. 



IN 



Insert New Records 



IN causes Edit to insert new records into a file. The IN 
command has the format shown below. 

*IN[nr,,]] 

New records are inserted storting at the record with sequence 
number n, with each successive record being sequended from n 
with increment i. If i is omitted, the increment size speci- 
fied in the most recent insertion command is used. If no such 
commands have been given, the value 1 is assumed by default. 
If n is omitted also the insertion is made at the most recent 
insertion line plus the increment value. If there were no 
prior insertions, the assumed value for n is 0. Commands 
which can set the default increment or the default next in- 
sertion line are MK, MD, IN, IS, and C. If a record with 
sequence number n exists in the file, it Is replaced by the 
newly inserted record n. 

Edit prompts the user with the first sequence to be inserted, 
and repeats the prompt for each subsequent insertion, in- 
creasing the sequence number by the increment i. 

The insertion can be terminated in one of three ways. If a 
null record (Honly) •» supplied, the insertion terminates. 
An equivalent action takes place if an incremented se- 
quence equals or exceeds a sequence existing in the file. 
In the latter case, the console bell is rung. The insertion 
is also terminated (and an error message is printed) if an 
attempt is made to insert a record having a record number 
greater than 9999.999. 

Example : 

•EDIT SOURCEFILE H 

•IN 100, . 1 «•'* 

100.000 I0A = 2.5 fr i> Reploces^he existing record. 

100.100 B = 0.«j> 

• Record insertion terminates 

~ because sequence number 

100. 200 existed previously; 

the console bell is rung. 
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IS 



Insert New Records 



The IS command it identical to the IN c ommand in function 
and format except that Edit does not prompt with sequence 
numbers. The format of the IS com m and is: 

Example: 

•EDIT SOMEFILE © 
*IS 100, . 1 © 
10 A = 2.5© 

B = 0© 

© 



Example: 

•EDIT SOURCEF1LE © 
*TY 1-2,4,8© 
1.000 EQU 



1.200 


SYST 


1.400 


REF 


1.600 


DEF 


1.800 


PAGE 


2.000 


1T1AL 



DE 



Delete Records 



DE causes Edit to delete all records whose sequence num- 
bers lie in a specified range. The DE command has the 
form shown below. 

*DE n[-m] 

where 

n specifies the number of the first record to be 

deleted. 



m 



specifies the number of the last record to be de- 
leted. If m is omitted, only record n is deleted. 



Example: 

•DE50© 



Deletes record 50.000 only. 



TY 



^DE 50-60.5© Deletes all records in the range 
~ 50.000 through 60.500, inclusive. 



Type Records, Sequence Numbers Included 



TY causes Edit to write to the M : LO DCB the sequence 
numbers and the contents of specified columns of one or 
more records. In addition, it causes Edit to enter the in- 
trarecord mode as though an SE command had been given. 
The TY command has the format shown below. 

nYn[-m][,cl,d]] 

Edit types records in the range n to m, and types only the 
portions between columns c and d. If m is omitted, only 
record n is typed. If the values for c and d are not given, 
c has a value of 1 and d has a vaule of 140 by default. 



TC Type Compressed 

TC causes Edit to write to the M:LO DCB the sequence 
numbers and the contents of specified columns of one or 
more records. Any nonblank strings within the columns are 
shifted to the left to compress each blank siring to a single 
blank. This compression affects only the output; the rec- 
ords themselves are not affected. TC is the same as TY with 
all blank strings compressed to a length of one. Like TY, 
TC causes Edit to enter the introrecord mode as though an 
SE command hod been given. The TC command has the 
format: 

•TCn[-m][,c[,d]] 



Edit types records in the range n to m, and types only the 
portions between columns c and d. If m is omitted, only 
record n is typed. If the values for c and d are not given, 
c has a value of 1 and d has a value of 140 by default. 



Example: 

•EDIT SOURCEFILE © 
*TC 1-2, 1,7© 
1.000 A EQU 



1.200 SYS 


1.400 B REF 


1.600 C DEF 


1.800 PAGE 


2.000 *INITIA 
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TS Type Records, Sequence Numbers Not Included 

TS causes Edit to write to the M:LO DCB tho contents of 
specified columns of one or more records, without accom- 
panying sequence numbers. In addition, it causes Edit 
to enter the intrarecord m>de as though an SE commond 
had been given. The TS command has the format shown 
below: 

*TSn[-m][,e[,d]] 

Edit types records in the range n to m, and types only the 
portions between columns c and d. If m is omitted, only 
record n is typed. If the values for c and d are not given, 
c has a value of 1 and d has a value of 140 by default. 



Example: 

•EDIT SOURCEFILE © 
*TS 1-2,1,8© 
A EQU 
SYS 
B REF 



C DEF 



PAG 



'1N1TIA 



MD 



Move and Delete Records 



MD causes Edit to move records from one specified range 
to another. The original records are deleted as they are 
moved. Records in the destination range are also deleted. 
The MD command has the form shown below. 



•MD n[-m],k[-p][,i] 



where 



n specifies the sequence number of the first record 
that is to be moved and deleted. 

m specifies the sequence number of the last record 
that is to be moved. If omitted, only n is moved 
and deleted. 

k specifies the lower limit (i.e. , sequence number) 
of the range of destination records that will be 
deleted. 

p specifies the upper limit of the range of records 
to be deleted. If omitted, only k is deleted. 
, However, records from the range n-m are still 



moved to record k and following until a record is 
encountered, that originally followed record k in 
the file. (When such a record is encountered, no 
more records are moved. ) 

i specifies the increment value to be used for re- 
numbering records. If omitted, the most recent 
increment value specified in a record edit com- 
mand is used. If no such commands have been 
given, the default value is 1. 

The first record (n) is renumbered as k. Successive records 
from the range n-m are renumbered consecutively higher, 
incremented by i. 

It is important to note that the ranges n-m and k-p may not 
overlap. 

As each record from the range n-m is moved, it is deleted 
from the original range (n-m). At the end of this operation, 
a message is printed specifying the new sequence number 
of the last record moved from the range n-m. 

Example: 

•EDIT BETA © 

•MD5-21, 100-101, .02© 

—DONE AT 100.32 

If the increment is too large to permit all records in the 
range n-m to be moved into the space between k and the 
next record after p, a message is printed specifying the 
sequence numbers, from both ranges, of the last record 
moved. 

In this case the original contents of range k-p will be lost, 
but only those records in the range n-m that have actually 
been moved wilt have been deleted. Thus, the user can 
perform another move (with a smaller increment) to move 
the remaining records in the range n-m. 

Example: 

*EDIT BETA ■»» 

•MD 10-30, 100-1 10, 1 H 

—CUTOFF AT 110. (20.) 20 is the number of the 
last record that was moved. 



UK 



Move and Keep Records <+ 



MK is identical to MD except that the records in the range 
n-m are not deleted as they are moved; thus a copy of rec- 
ords in the range n-m is mode. The MK command has the 
form shown below. 

•MKn[-m].k[-p][,i] 
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FO 



Find and Delate Records 



FD causes Edit to search tor a specified string between 
specified columns. If the string is found, the record con- 
taining it is deleted from the file, lhe FO command has 
the form shown below. 

•FDn[^],/string/[,c[,d]] 

where 

n specifies the sequence number of the first record 
to be searched. 

m specifies the sequence number of the last record 
to be searched. If omitted, only record n is 

searched. 

/string/ specifies the character string identifying 
the record to be deleted. 

c specifies the lower limit (i.e., column number) of 
the field to be searched. The default volue is 1. 

d specifies the upper limit of the field to be 
searched. The default value is 140. 

The specified string must be entirely contained within 
columns c through d to cause deletion. At the end of this 
operation, a message is printed telling how many records 
were deleted. 

•EDIT FILEA © 

*FD 5-20.4,/DATA/, 10, 18 © 
—006 RECS DLTED 

If there are no records in the specified range containing 
the indicated string, Edit prints the following message: 

—NONE 



5.000 


LW,3 


DATA 


9.000 


LW.2 


TABLE.7 


21.480 


LW.10 


LOC+5,8 


73.000 


LW,9 


FLAG 



If there are no records in the specified range containing 
the indicated string, Edit prints the message 

—NONE 



FS 



Find and Type Sequence Number 



FS causes Edit to search a given range of records for a 
specified character string between designated columns. 
Edit will write to the M:LO DCB the sequence number of 
each record satisfying the search criteria. The FS command 
has the format: 

*FS n[-m], /string/ [,c[,d] J 

The p arameter specifications are the same as those for the 
FD command. 

Example: 

•EDIT SOMEFILE © 
•FS 10-20,/BE/,10,ll© 
15.000 
18.000 



FT Find and Type Record and Sequence Number 

FT causes Edit to search for a specified string between 
specified columns. If the string is found, Edit writes the 
sequence number and the contents of the record to the 
M-.LO DCB. (The string must be entirely contained within 
the specifiec columns. ) The FT command has the format: 

•FT n[-m],/string/[,c[,d]] 

The parameter specifications are the same as those for the 
rU cofTtfnond. 

Example: 

•EDIT SOMEFILE © 

•FT 1-100,/LW/,10© 



If there are no records in the specified range containing 
the indicated string, Edit prints the following message: 

—NONE 



IN 



Renumber Record 



RN causes Edit to renumber a specified record. The RN 
command has the form shown below. 2 



*RNn,k 

This has the same effect as deleting record n and then 
entering a new record with sequence number k with the 
same contents as n. Sequence number k must not already 
exist. 
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CM 



Insert Commentary 



Sat and Stop 



CM causes Edit to insert commentary Into specified columns 
of each successive rocord boginning ota specified sequence 
number. The CM command has the format shown below. 

•CMn,c 

where 

n 

c is the column number. 



is the record number. 



The sequence number of each record it typed and then 
the user types in the data he wants inserted starting at 
column c. The data he types in is blank filled to the 
right through column 140, as required. A null record 
terminates the command. It is not necessary to delimit 
commentary with slashes. 

Example: 

'EDIT SOURCEFILE «c 

•CM 37. 6, 40 6 

37.600 ' COMMENT 1 •;- 

37.800* COMMENT 2 i- 

40. 500 * W 



SS couses Edit to start at a specified record and proceed to 
each record in succession, accepting one line of intra- 
record commands to update the current record. The SS com- 
mand has the format shown below. 

*SSn[,c[,d]J 

The first record to be updated has the sequence number n. 
bitrarecord string-matchingoperotions will only be effective | 
on strings that lie wholly within columns c through d. The 
default values for c and d are 1 and 140, respectively. 

Edit prompts for commands for each successive record with 
the sequence number, followed by a double asterisk. The 
SS command is terminated by typing a null record in place 
of an introrecord command. 



ST Set, Step, and Type Record 

This command is similar to SS except that the content of 
eoch record is written to the MLO DCB along with its 
sequence number, prior to accepting a command. The ST 
command has the format shown below. 

•STn[,c[,d]] 

The parameters of the command and the error messages 
which Edit types are the same as those for the SS command. 



SE 



Set Introrecord Mode 



SE causes Edit to accept successive lines of introrecord 
commands. The SE command has the format shown below. 

*SEn[-m][,c[,d]] 

Each input line of introrecord commands is applied, in 
order, to columns c through d of every record in the 
range n through m. If m is missing, only record n is pro- 
cessed. The default values for c and d ore 1 ond 140, 
respectively. 

If several commands are entered on one line, all commands 
on the line are executed on one record before the next rec- 
ord is processed. The first occurrence of a file or record- 
editing command terminates the effect of the SE command. 
All string-matching operations in the intrarecord mode 
apply only to the strings lying entirely within columns c 
through d. 

SE may be used on the same input line with other intra- 
record commands, but when so used, it must be the first 
command on the line. 



WTMREGORO E0ITM6 COMMANDS 

The intrarecord commands make changes within an individ- 
ual record. They generally manipulate character strings. 
These commands may only be given after the user selects 
an intrarecord mode with the SE, SS, or ST com m and s . 

The intrarecord commands will be discussed in the fol- 
lowing order: 



Y or N Conditional command continuation. 

CL Change column limits for string matching. 

S Substitute string. 

D Delete string. 

P Insert string preceding. 

F Insert string following. 

O Overwrite string. "* 

E Overwrite string; blank fill. 

R or L Shift string. 

A Align columns by shifting. 

C Copy with another line number. 
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OE Delete individual line. 

JM Type individual records. 

JU Jump to new sequence. 

NO No ch snge. 

RF Reverse blank preservation flag. 

Commands in the Introrecord group may be linked together 
through use of the semicolon fc). The following command 
sequence would select a line, type the original, edit, and 
type the new version: 

^SE 100; TY; /i^P/S/B/;/JK/FABETA/;TY© 

After any semicolon, the command may be continued on the 
same or the following line, with identical results. 

The following conventions ore used with inrrarecord commands: 

1. j/string/x 

means that command x is to operate on the jth occur- 
rence of the indicated string found between columns c 
through d as specified by an SE, SS, ST, or CL com- 
mand. If ]=0, this means that the command is to oper- 
ate on all occurrences of the string between columns c 
and d. If j is missing, the default is 1. A single / 
may be included in the string by typing two slashes in 
succession. 

2. kx 

means that command x is to operate on the character 
contained at column k, where k need not lie between 
columns c and d of the SE, SS, ST, or CL command. If 
k is '999', the column following the last non-blank is 
indicated. 

Whenever an S, D, P, F, O, E, R, L, or A command is 
given, Edit responds in one of the following ways: 

1 . A prompt alone indicates that either no change or one 
change occurred as a result of the command. 

2. The message 

x STRINGS CHANGED 

fol lowed by a carriage return and a prompt indicates 
that x changes occurred as a result of the command. 

The following general error is possible: 

-MISSING SE No SE command was given. Either 
an SE, SS, or ST command must be given in 
response to this message. 

Before reading the inrrarecord command descriptions, it is 
important to note the following information: 

Note: In any inrrarecord command that seeks a matching 
string in the image, only those strings that lie 



totally within the specified column bounds will be 
found. Partial matches to a column boundary will 
be ignored, bi subsequent examples, references 
to columns c and d pertain to the column bound- 
aries given in the SE, SS, ST, orCL command. 



Y art N Continue if Yes and Continue if No 

These inrrarecord commands provide for conditional execution 
of other intrarecord or branch commands. The format is 

[. . .;]n/string/Y[;. . .]or 
[. . .;]n/srr?ng/N[;. . 3 

where "n" is an optional nonzero occurrence count. 

Both commands affect the execution of any other commands 
which follow them on the same command line or its continua- 
tions. The commands which follow Yore executed only if 
the string defined in the Y command is matched. The com- 
mands which follow N are executed only if the string is not 
■notched. In the cose where a range of lines is being edited, 
the decision is made independently for each line. 

Example: 

*TY 1-1000 © 
1.000 A 



2.000 


BX 


3.000 


CXX 


4.000 


D 


*/X/Y; TY 
2.000 BX 


3.000 


CXX 


^2/XA; TY © 
3.000 CXX 


*/X/N; TY © 
1.000 A 


4.000 


D 


ryX/N;TY© 
1.000 A 


2.000 


BX 


4.000 


D 
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CL Chans* String-Search Column Units 



Delete String 



This introrecord command allows modification of the column 
limits for string matching operations. The format is 

[...;Kl[c[,d]X...] 

Where V is the new first column, and 'd' is the new last 
column for string-matching operations. If 'd' is omitted, it 
defaults to 140. If both V and 'd' are omitted, the defaults 
are 1 and 140, respectively. The new column limits remain 
in effect until the next SE, SS, ST, or CL command. 

Example: 

•TS 1 

NO CHANGE 

*CL1,4;/A/Y;/NO/V /;TS 
NO CHANGE 
. *CL5,8;/A/Y;/NO/S/ /;TS 
NO CHANGE 

*CL5, 8;/A/Y;C LI , 4;/NO/S/ /;TS 
CHANGE 



D causes Edit to locate a given occurrence of an indicated 
string, between) columns specified by an SE, SS, or ST 
command, and delete it. The D command has the format 
shown below. 

^fjj/string/D 

If j = 0, all occurrences of the string between c and d ore 
deleted. Otherwise, only the jth occurrence is deleted. 
If j is omitted, the default value is 1. 



Example: 

•EDIT SOMEF1LE © 
*TY7© 

7.000 STW/4 



ALPHA ANSWER 



•SE7© 

yANSWER/D © 
*TY7 © 

7.000 STW/t 



ALPHA 



S Substitute String 

S causes Edit to locate a specified string (string]) between 
columns specified by an SE, SS, or ST command and replaces 
it with another string (string2). The S command has the 
format shown below. 

^/stri ng /S/stri ngj/ 

The image to the right of string] is adjusted right or left 
as required, if the lengths of string] and string2 differ. 
String2 may extend past column d if d < 140. 

If j =0, all occurrences of string] between columns c and d 
are replaced by string2- Otherwise, only the jth occur- 
rence is replaced. If j is missing, the default value is 1. 

Example: 



Command 


Effect 


yLw/s/cw/ 


LW,R5 ALPHA+2 old 
CW,R5 ALPHA+2 new 


yio/s/s/ 


LW,R10 B old 
LW,R5 B new 


yH0/S/ENTRY/ 


$10 
ENTRY 


LW.R5 ALPHA old 
LW,RS ALHPA new 


yALPHA/S/B/ 


LW,R5 ALPHA+2.R6 old 
LW,R5 ft+2,R6 new 


•2/5/S/55/ 


15 
15 


C=OISQRT(TEMP+2.5 
•BASE) old 

C=DSQRT(TEMP+2.55 
•BASE) new 



P Precede String 

P causes Edit to start before the first character of a given 
occurrence of a specified string (string]) or column k and 
insert another string (string2), pushing characters of the 
first string to the right as required to make room. The 
P com m and has the format shown below. 

• j /string j/P/string^ 



or 



*kP/string 2 / 



String2 may legally extend beyond column d if d < 140.' 
The first character of string2 will occupy the column va- 
cated by the first character of string., etc. 

If j =0, Edit will insert stringy before all occurrences of 
string] between columns c and d. However, after string] 
has been found once and string2 inserted before it, scan- 
ning for the ntxt occurrence resumes at the next character 
after string], as adjusted by the insertion. If j is not equal 
to zero, the command will only affect the jth occurrence 
of string). If j is omitted, the default value is 1. 

Example: 4 

•SE 17. 69 © (set introrecord mode) 

•TS;0/AA/P/./;TS © (type; edit; type) 

AAAAAAA (original record) 

.AA.AA.AAA (edited record) 



Edit Comm a nd s 207 



F Follow String 

F causes Edit to (fart after the last character of a given 
occurrence of a specified string (string]) or column Ic and 
insert another string (string2)/ pushing everything from this 
columi right as required to make room. The F command 
has the format shown below. 

Itfl/stringj/F/itringj/ 

or 

*lcF/string 2 / 

The j specifies that the jth occurrence of string] between 
columns c and d (specified by on SE, SS, or ST command) 
is to be followed by string2. If ] is omitted, the default 
value is 1. In the case where j = 0, Edit inserts string2 
at all occurrences of string] between columns c and d. 
Scanning for the next occurrence of string] resumes follow- 
ing the last character of stringy. If a given occurrence of 
string^ is shifted beyond column d due to previous inser- 
tions, it will not be scanned. 

String2 may legally extend past column d if d < 140. 

Example: 



Command 


Effect 


yAB/F/+2/ 


LW,R6 
LW,R6 


AB,R2 
AB+2,R2 


old 
new 


Overwrite 









O causes Edit to start at the column occupied by the first 
character of a given occurrence of a specified string 
(string^ ) or column k and overwrite with another string 
(string2). No blank preservation or other adjustment is 
done and all columns not overwritten remain unchanged. 
The O command has the form shown below. 

^fj/stringj/O/stringj/ 



or 



*kO/string 2 / 

String2 may overwrite beyond column d if d < 140. The ! 
specifies that the jth occurrence of string] between affected 
columns is to be overwritten by string2- If j is omitted, only 
the first occurrence is overwritten. If ] = 0, all occur- 
rences are overwritten. In the case where j = 0, string 2 is 
not scanned by Edit after string] is overwritten. Edit begins 
scanning with the column following string2. 

E Overwrite and Extend Blanks 

E causes Edit to start at the column occupied by the first 
charocter of a given occurrence of a specified string (string j) 
or column k and overwrite with another string (string2). The 
E command has the format shown below. 

^j/stringj/E/string^ 
Nee/string^ 



Blanks or* e x ten de d from the end of string2 through eol- 
umn d (where d is the upper limit of the column range 
■elected by an SE, SS, or ST command). String2 may 
overwrite beyond column d if d < 140, but blank exten- 
sion only occurs through column d. 

The j specifies that the jth occurrence of string] between 
effected columns is to be overwritten by string2. If j is 
omitted, only the first occurrence is overwritten. The 
specification j = may not be specified, since blank ex- 
tension precludes multiple substitutions within the some 
record. 



R tr L Shift Record Image 

R or L commands cause portions of the record image to be 
shifted right (R) or left (L). The R and L commands have 
the form shown below. 



or 



•rj]/M,lng/([}. 



The string must lie wholly within columns c and d specified 
by the current SE, SS, or ST command. The specified sub- 
string may contain embedded blanks, but the string to be 
shifted terminates with the first blank following the spec- 
ified substring. 

The j specifies that the jth occurrence of the specified sub- 
string between affected columns is to be shifted, together 
with all subsequent contiguous nonblank characters. If j 
is omitted, only the first such occurrence is shifted. Note 
that j = may not be specified for this command. 

L Shift Left 

The jth field that begins with the indicated string (or col- 
umn k) is shifted left s positions. If blank preservation (see 
the BP command) is ON, all of the fields to the right of the 
string are shifted left, intact, ond the fields to the left of 
the string are overwritten (i.e., destroyed). If blank pres- 
ervation is OFF, blanks are inserted to the right of the jth 
field, and the fields to the left of the string are overwrit- 
ten. The shift may legally overwrite below column c. 

R Shift Right 

The jth field that begins with the indicated string (or col- 
umn k) is shifted right s positions. If blank preservation 
is ON, blanks ore inserted to the left of the string and all 
of the fields to the right of the string are shifted right, in- 
tact. If blank preservation is OFF, blanks are inserted to 
the left of the string and are removed to the right. With 
blank preservation OFF, the image area to the right of the 
string may be compressed, but at least one blank will be 
left between each field; that is, overwriting does not occur 
in a shift right. The shift may legal ly push characters be- 
yond column d, if d is less than 140. 
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In the following examples, blank preservation h OFF. 



WOfwnond 


Effect 


yi/Ri 


$10 ' ~LW,R6 
$10 LW,R6 


B 
B 


eld 
new 


•/L/R9 


$10 LW,R© 


B 
LW,R6B 


old 


yi/u ^ 


$10 LW,R6 
LW,R6 


B 
B 


old 
new 



A Align Specified Columns 

The A command causes either a right or left shift of o part 
of the record being edited to align one specified column 
with another. The details of the shift operation are as de- 
scribed for the R and L commands. The form of the com- 
mand is 

[...;]cAd[;...] 

where "c" specifies the column to be aligned and M d" speci- 
fies the column to which to align. The "c" and "d" items 
can be any of 



an integer column number, 

/string/ 

specifying the first column of the first occurrence of the 
string, or 

n/string/ 

specifying the first column of the "n"th occurrence of the 
string, ("n" can not be zero for this command.) 



Example 



^SE 1-3; TS 
-ONE 
XXXXX 



■TWO. TWO 



-THREE THREE THREE 



*/-/A5;TS 
-ONE 
-TWO 



TWO 



-THREE THREE THREE 



Note the distinction between left-shift (TWO) and right- 
shift (THREE) behavior. 

^$E 20; TS '-, 

*ONE *TWO 'THREE 



»3/*/A 2/*/; TS ' 
»ONE *THREE 



C Copy Current Line 

This intraline command causes the line being edited to be 
copied with o specified or provided sequence number. The 
original line it unaffected by this command. The format is 

[...;] C[.][;...] 

where S* is a sequence number at which to copy the line. 
If "t" is not specified, the current default increment is 
added to the sequence number to which the last C applied, 
to provide the new sequence number. Commands which can 
set the default increment or the default next insertion line 
number are MK, MD, IN, IS, and C. 



Example: 

•TY 1-1000 (••'> 
1.000 A 



2.000 


BX 


3.000 


CXX 


4.000 


D 



IS 101© 

.© 

^SE 1-99; /X/Y,C 
*TY 1-1000 S 
1.000 A 



2.000 


BX 


3.000 


CXX 


4.000 


D 


101.000 


BX 


102.000 


CXX 



DE 



Delete Current Record 



If used without a specified sequence number, DE becomes 
an intrarecord command, which specifies that the record 
currently open for editing be deleted. Ihe form is 

[. . .;] DE 



Note that it must be the lost command in a command 
line, since once it is executed, there is not anything 
left of the currently open line. 
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Example: 

nY 1-10000 
1.000 A 



2.000 


BX 


3.000 


CXX 


4.000 


*D 



•/x/y ; de 

•TY© 
1.000 A 

4.000 D 

TS Type Record, Sequence Number Not Included 

TS causes Edit to write to the M:LO DCB the contents of 
the record currently open for editing under control of an 
SE, SS, or ST command. (Unlike the record-editing ver- 
sion, the intrarecord version of TS does not allow column 
specification. ) 

The TS command has the format shown below. 

^ ..;]TS[;...] 

The three dors indicate that intrarecord commands may pre- 
cede or fbl low the TS command. 

Exomple: 

*SE 5; TS 8 

LI LW,5K 

•190/KLB/; TS; 370/GET KLB/; TS0 

(overwrite, type, overwrite, type) 

LI LW,5 KLB 

LI LW,5 KLB GET KLB 

Because all commands on a single input line are executed 
for the first record before the second record is processed, 
etc., TS will type each line in turn after all editing up to 
the TS command has been done. 

ExampU: 

fSE 10-10.2© 
^A/F/,4/;TS© 



DATA,4 


X'FF* 


00.0) 


DATA,4 


0.5 


00.1) 


DATA.4 


GQX. X'OB' 


(10.2) 



TY Type Record, Sequence Number Included 

TY is the same as TS, except that each line is written 
with its sequence number. (Unlike the record-editing 
version, the intrarecord version of TY does not allow 
column specification. ) 

The TY command has the format shown below. 

•[...;]TY [;...] 



JU 



Jump 



JU couses the SS or ST command to jump to a specified rec- 
ord and then continue stepping from that point. JU may 
only be used while in the "step" mode (i.e., while under 
the control of an SS or ST command). The JU command has 
the form shown below. 

•[...;]JUn 

Record n may be forward or backward from the current se- 
quence number at the time JU is given. The dots indicate 
that JU may be used on compound lines (i. e. , a line with 
more than one command on it), but in such a case JU must 
be the last command on the line. 



NO 



Moke No Change 



NO may be used only while in the "step" mode and speci- 
fies that no editing is desired on the current active line 
under the tat. The NO com man d has the format shown 
below. 



•NO 



Example: 






^ST27.5© 






27.500 


LW,6 


BLK 


♦NO© 






30.000 


STW,6 


ALT 



VALT/F/+19 ; TY ; JU 34 @ 

30.000 STW,6 ALT + 19 



34.000 



A1,F X'91' 
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HF Reverse Blank Preservation Mode 

RF causes th« currant setting of th« blank preservation 
mode (tee the BP command) to be reversed temporarily. The 
RF command has fha form shown below. 

I* * " f] ** i • • • 



• • • } Krl; ■ • •! 

The mode is reversed only for the duration of the input 
line in which RF appears and only for those commands 
which follow the RF command, and blank preservation 
is restored to its initial setting when a new input line 
is entered (i. e. , at the time a new prompt character is 
given). Thus, to have any effect, RF must always be 
used as part of a compount input line and must be followed 
by other commands. 

Example: 

*SE 10; TY 

10.000 15 LW.4 X GET CURRENMT ADDR 

*RF;/NAVS/N/;TY0 

10.000 L5 LW,4 X GET CURRENT ADDR 

Without using RF in this case (assuming that BP OFF is the 
initial setting), one would get two blanks after CURRENT. 
In all cases, the BP mode is restored to the value it had 
before any RF commands were given. 



Possible messages are summarized in Table 22. The follow- 
ing conventions are used in regard to message formats: 

1 . A message preceded by two periods is a comment on 
some system- or ientei operation. For example, 

..COPY DONE 



2. 



A message preceded by two minus signs indicates the 
occurrence of some event (during the execution of a 
command) of which the user should be aware; the com- 
mand is not aborted. For example, 

—EOF HIT AFTER xxxx. xxx 



3. A message preceded by a single minus sign is an error 
message describing a condition that aborts the current 
command and causes any others on the same line to be 
skipped. For example, 

-PI: NO SUCH REC 

Such a message is particularized as to cause by the follow- 
ing prefixes: 

Prefix Cause of Error 

-Ck: The kth command of the previous line caused 

the error. 

-Pk: The kth parameter of the first command on 

the previous line caused the error. 

-CkPj: The jth parameter of the kth command of 
the previous line caused the error. 



MESSAGES 

During the course of executing any command, Edit may 
communicate with the user through a variety of messages. 
These messages are directed to the LL oplabel. 



EDIT COMMAND SUMMARY 

Table 23 is a summary of Edit commands. The left-hand 
column gives the command formats. The right-hand col- 
umn gives the command functions and options. 



Table 22. Edit Messages 



Message 


Meaning 


-BAD COL NO. PAIR 


The columns specified are not in the range 1 through 140, or c > d. 


— Cn: 'ALL' IGNORED 


The value was specified for j. Since this value is not meaningful for the 
command, the value 1 has been assumed. 


-Cn: CMND1LGLHERE 


The nth command of the previous line is invalid and the intnrecord mode 
has been terminated. 


-Cn: COL > LIMIT 


The value specified for k is greater than d for the nth command. 


-Cn: COL < LIMIT 


The value specified for k is less than e for the nth command. 


-Cn:- ILGL SYNTAX 


Invalid command syntax has been used. 
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Tabic 22. Edit Manages (coot. ) 



Message 


Moaning 


-Cn: NO SUCH REC 


The record specified in a JU command (the nth command) does not exist. 


-Cn: OVERFLOW 


The nth command of the previous line has caused characters to be shifted 
past column 140. Processing continues. 


—Cn: UNDERFLOW 


Characters were lost to the left of the record. 


-Cn: UNKNCMND 


The nth command specified is not one recognized by Edit. 


-CUTOFF AT x(y) 


A specified operation could not be completed because of a conflict between 
an existing sequence number and a new one. The value x is the current 
sequence number of the last record affected (formerly record y). 


—DONE AT x 


A specified operation has been completed. The value x is the current 
sequence number of the last record affected. 


—EOF HIT AFTER xxxx. xxx 


One or both sequence numbers specified are higher than the highest one in 
the file. xxxx. xxx is the last record in the file. 


-ILLEGAL LINE NR IN SUBJECT FILE 


Sequence numbers were being obtained from the subject file records and a 
record was found without a correct sequence number in its last eight bytes. 


— LINES REORDERED 


Sequence numbers were being obtained from the subject file records and 
they were not in numeric order j They will be reordered numerically. 


-MAX. SEQ. NO. EXCEEDED 


An attempt was mode to insert a record with a record number greater 
than 9999.999. 


-MISSING SE 


No SE, SS, or ST command is currently in effect. The specified intrarecord 
task has been aborted. 


-NO FILE NAMED 


The command requires a file identification and none was given. 


-NO SUCH FILE 


A specified file does not exist. 


—NONE 


There ore no records in the specified range containing the indicated string. 


-NOT OrVOFF 


A parameter other than ON or OFF has been specified in a BP or CR command. 


—NOTHING TO MOVE 


No records (to be moved) were found in the specified range. 


—OVERFLOW 


More than 140 characters have been typed on a line or characters have been 
shifted past column 1 or 140. Excess characters are lost. 


-PI: NO SUCH FILE 


A COPY command has specified that a nonexistent file is to be copied. 


-PI: NO SUCH REC 


A specified record does not exist. The command has been aborted. 


-P2: COL ERROR 


Column c is greater than 140. 


-PI: RLE EXISTS 


A SAVE ON command specified the name of an existing file. 


-P2: REC EXISTS 


A specified record already exists. The command has been aborted. 


-P3: NOTINCR 


An invalid increment has been used In a BUILD command. 


-Pn: BAD FID 


An invalid fid identification has been used. 
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fable 22. EdiiMeiiogoifeont.) 



Manage 


Meaning 


-Pn: ILGLSEQ' 


A required sequence number it misting or contains more than three frac- 
tional digits. 


-Pn: ILGLSTRG 


The specified string is too long. 


-Pn: IL«L SYNTAX 


An invalid syntax has been specified for a parameter. 


-Pn: NOTCNT 


An invalid occurrence count (j) has been specified in an intrarecord 
command. 


-Pn: NOT COL' 


An invalid column number has been specified. 


-Pn : NOTSEQ' 


A required sequence number is invalid. 


-Pn: NOTSTRG 


An invalid character string has been specified. 


-Pn: NULLSTRG 


A null character string has been specified. 


-Pn: PARAM MISSING 


A required parameter has not been specified. 


-Pn: SEQ2<SEQ1 


The second sequence number is less than the first in a range specification. 


xxxxxxx RECORDS DELETED 


xxxxxxx specifies the number of records deleted as the result of either a 
DE or MD command. 


—REPEATED LINE NR. . . DELETED 


Sequence numbers were being obtained from the subject file records 
and a duplication was found. Only the last line is retained. 


— RNG OVERLAP 


Specified ranges of sequence numbers overlap. The command has been 
ignored. 


—SAVE FILE TOO SMALL: FS! = yyyy 


The estimated size needed to save is "yyyy" records. If the command was 
SAVE without parameters, END, or EDIT, the save file is unchanged and 
the command hod no effect. Otherwise, the save was partially completed. 


—SCRATCH FILE OVERFLOW 


The scratch file is too small for the most recent command to be completed. 
Multiline commands may have been executed on some lines. No lines have 
been partly completed. 


x STRINGS CHANGED 


As the result of an intrarecord command, x strings have been changed. 



Table 23. Edit Command Summary 



Command 


Description 


[...;]c Ad [;...] 

where c and d are 

k 
or 

[j]/string/ 


Aligns the first specified column with the second. Column* are specified 
by either the column number k, or as the first column of the specified 
string. 

Option: 

j specifies the jth occurrence of the specified string. Default is 
the first occurrence. 
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Table 23. Edit Command Summary (cont. ) 



^oivwnciK] 


Description 


•8SJI] 


Soft the blank preservation mod*. Whan ON, all strings of blanks ore 
preserved during intraracord operations. When OFF, blank strings are com- 
pressed to o single blank or expanded as required to retain column align- 
ment of nonblank fields. The default mode is "off. 


[...;)C[.I;...] 


Copies the current edit line with another sequence number. 

Option: 

s specifies the sequence number tor the cop/. Default is the se- 
quence number used by the prior insertion command plus the incre- 
ment most recently specified in any prior command. If there was 
no prior insertion command, s is zero plus the increment. If there 
rs no prior increment, I is used. 


CL[c[.d]J 

i 


Changes the string-search column limits for intrarecord commands. 

Options: 

c is the new first column number. If it is not specified, it defaults 
to 1. 

d is the new last column number. If it is not specified, it defaults 
to 140. 


CMn,c 


Causes Edit to insert commentary (given by the user) into specified columns 
(storting at column number c) of each successive record beginning at the 
specified sequence number n. 


[j]/string/D 


Locates a given occurrence of the indicated string. Between columns speci- 
fied by on SE, SS, or ST command, and deletes it. 

Option: 

( specifies that only a particular occurrence (the jth occurrence) 
of the string in the specified columns is to be deleted. If j equals 
zero, all occurrences of the string in the specified columns are to 
be deleted. If j is omitted, the default value is 1. 


[...;JDE 


Deletes the current edit line. 


DE n[-m] 


Deletes all records whose sequence numbers lie in a specified range be- 
ginning at n. 

Option: 

m indicates the number of the last record to be deleted. If m is 
omitted, only record n will be deleted. 


[J3/»^in9/E/*lring 2 / 

or 

kE/»1ring 2 / 


Starts at a column occupied by the first character of a given occurrence of 
a specified string (string]) or column k and overwrites with another string 
(string2). Blanks are extended from the end of string2 through column d 
(which is specified in an SE, SS, or ST command). 

Option: 

J specifies that the jth occurrence of string] between affected col- 
umns is to be overwritten by str?ng2. If ] is omitted, only^rhe first 
occurrence h overwritten; ] may not be zero. ,. 


EDIT fidl OVER fid2 [, start [, step]] 

or 

EDIT f!d2 


Prepare for editing the data in file "fidl" (if specified) using file"fid2" as 
the scratch file. 

Options: 

start and step specify the sequence numbering. 
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TabU 23. Edit Command Summary (cont. ) 



t~ 



Command 


Description 


END [NS] 


CIoms all aetiva files and returns control to tKe terminal executive 
language (TEL). 

Option: 

No save of the edited data on the subject file. 


[ jyrtring j/F/jtringj/ 

or 

kF/string-/ 


Starts after the last character of o given occurrence of a specified 
string (string]) or column k and inserts another string (string2), pushing 
everything from this column right as required to make room. 

Option : 

j specifies that the jth occurrence of string] between columns c 
and d (specified by an SE, SS, or ST command) is to be followed 
by srring2. If j is omitted, the default value is 1. If j equals 
zero, string* is inserted at all occurrences of stringi between 
columns c and d. 


FD n[-m],/string/[,e[,d]] 


Searches for the specified string between specified columns in a specified 
range of records beginning at record n. If the string is found, the record 
containing it is deleted from the file. 

Options: 

m specifies the sequence number of the last record to be searched. 
If omitted, only record n Is searched. 

c specifies the lowest column number of the field to be searched. 
The default value is 1. 

d specifies the highest column number of the field lo be searched. 
The default value is 140. 


FS n[-m],/itrina/[ ( c[ ( d]] 


Searches for the specified string between specified columns in a specified 
range of records beginning at record n. Each time the string is found, the 
sequence number of the record is printed. 

Options : 

Same as for FD. 


FT n[-m],/string/[,c[,d]J 


Searches for the specified string between specified columns in a specified 
range of records beginning at record n. Each time the string is found, the 
sequence number and the contents of the record are printed. 

Options: m 

Same as for FD. 


[...;] GO t 


Begins using the Edit file as a command source by reading sequentially 
starting at sequence number s. If executed in Intrarecord mode, causes 
the specified command to be accessed, whether the end of the edit range 
was reached or not, but does not change the edit range. 



Edit Command Summary 215 



Ton ft 23 s edit Goiwnond Summary (cotw*) 



wOfivnoncf 



Description 



!N[n[,i]] 



Inserts new records into o file storting at record n. Edit prompts the uur 
with th« sequence number of each record to bo inserted. 

Options: 

n specifies the next record to insert. If omitted, the lost insertion 
record plus the increment is used. 

i specifies an increment amount for successive record numbers. If 
i is omitted, the increment size specified in the most recent record 
editing command is used. If no such command has been given, the 
default value is 1. 



lS[n[,l3] 



Inserts new records into a file storting at record n. Edit does not prompt 
with sequence numbers of the records to be inserted. 
Options: 

n specifies the t%«kt record to insert. If omitted, the last insertion 
record plus the increment h used. 

i specifies an increment amount for successive record numbers. If 
i is omitted, the increment size specified in the most recent record 
editing command is used. If no such commands have been given, 
the default value is 1. 



[• ..;]JU 



Causes the SS or ST command to jump to the specified record n and then 
continues stepping from that point. 



Option: 



The dots indicate that JU may be used on a line with more than 
one command on it, but in such a case JU must be the last com- 
mand on the line. 



MD[n-m],k[-p][,i] 



Moves records within a file from a range beginning at n to a range be* 
ginning at k. The original records are deleted. 

Options: 

m specifies the sequence number of the last record that is to be 
moved. If omitted, only record n is moved. 

p specifies the upper limit of the range of records to be deleted. 
If omitted, only record k is deleted. However, records from the 
range n-m are still moved to record k and following. 

i specifies the increment value to be used for renumbering rec- 
ords. If omitted, the most recent value specified in a record 
edit command is used. If no such commands have been given, 
the default value is I. 



MKr»[-m],k[-p][,i] 



MK is identical to MD except that the records in the range n-m are not de- 
leted as they are moved. 

Options: 

Same as for MD. 
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TobU 23. Edit Command Summary (cent. ) 



^Ofiwnond 


Description 


G • •;Xjy |trin fl/ N D« • •] 


Causa* the romoindor of the commands on the same command lino (and any 
continuations) to bo oxoeutod only if hSo spocifiad string is not found in the 
adit rocord. (Indopondontly determined for aoch racord in the odit range. ) 

Option: 

j spocifias the jth occurrence of the string. Otherwise, the first 
occurrence is sought. 


NO 


Specifies that no editing is to be performed on the current active line. 


[jj/stringj/O/itringj/ 

or 

kO/itrirW 


Starts at the column occupied by the first character of a given occurrence 
of a specified string (string i) or column (k) and overwrites with another 
string (string-). 

Option: 

] specifies that only a particular occurrence (the jth occurrence) 
of the string is to be overwritten. If j equals zero, all occurrences 
of the string are to be overwritten. If j is omitted, the default 
value is 1. 


[jJ/srrinSj/P/sfringj/ 

or 

IcP/stringj/ 


Starts before the first character of a given occurrence of a specified string 
(string j ) or column k and inserts another string, pushing characters of the 
first string to the right as required to make room. 

Option: 

Same as for the O command. 


D3/*iv{f}t 

or 


Shifts portions of the record right (R) or left (L) the number of positions 
indicated by s. The field to be shifted begins with the indicated string 
or column k. 

Option: 

] specifies that the jth occurrence of the specified substring be- 
tween affected columns Is to be shifted, together with all sub- 
sequent contiguous nonblank characters. If j is omitted, only 
the First such occurrence is shifted. Note that ] = may not be 
specified for this command. 


[...;] RET 


Returns immediately to M:SI for next command. If executed while in 
GO mode (that is, while obtaining commands from the edited file), GO 
mode is terminated. If executed as an intrarecord command, the current 
command line will be discarded in favor of the next command from M:SI 
even if the whole edit range has not been processed, but the edit range 
will not be changed. 


!• • • *J R* j? • • • 

or 

• • • i ™L» • * 'J 


Causes the current setting of the blank preservation mode (QN" or "OFF") 
to be reversed temporarily (for the current line only). 

Option: 

The dots Indicate that other commands are present on the line. 


RN n,k 


Renumbers a specified record from number n to number k. 
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Tabic 23. Edit C o m m a n d Summary (eont.) 



Comnond 


Description 


li\/ttTl^/S/*H\ng 2 / 


Locates a specified string (string]) between columns specified by an SE, SS, 
or ST command and replaces It with another string (string-). 

Option: 

] specifies that only a particular occurrence (the jth occurrence) 
of string] is to be replaced. If ] equals zero, all occurrences of 
string j are to be replaced. If j is omitted, the default value is 1. 


SAVE [SvER ndl ] 


Forces saving of the scratch file. 

Option: 

fidl specifies the file on which to save. Default is the sub- 
ject file. 


SEn[-m][,c[,d]] 


Causes Edit to accept successive lines of intrarecord commands to be ap- 
plied to records beginning at record n. 

Options: 

m specifies the number of the last record to which the intrarecord 
commands are to be applied. If omitted, the intrarecord com- 
mands are only applied to record n. 

c specifies the smallest column number of the range of columns 
to which the intrarecord commands are to be applied. The de- 
fault value is 1. 

d specifies the largest column number of the range of columns to 
which the intrarecord commands are to be applied. The default 
value is 140. 


SS n[,c[,d]] 


Sets the save file sequencing mode. 

Causes Edit to start at a specified record (record n) and proceed to each 
record in succession, accepting one line of intrarecord commands to up- 
date the current record. 

Options: 

c specifies the smallest column number of the range of columns to 
which the intrarecord commands are to be applied. The default 
value is 1. 

d specifies the largest column number of the range of columns to 
which the intrarecord commands are to be applied. The default 
value is 140. 




Causes Edit to start at a specified record (record n) and proceed to each 
record in succession, accepting one line of intrarecord commands to up- 
date the current record. The sequence number and contents of each rec- 
ord are typed prior to accepting a command. 

Options: 

Same as for the SS command. 
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TabU 23. Edit Command Summary (cent. ) 



Command 


Description 


TCn[-m][,c[,d]] 


Typos tho loquenco numbers and tho contents of specified columns of one or 
more records beginning at record n. Any nonblank strings within the columns 
typed are shifted to the left to compress each blank string to a single 
blank. 

Options: 

m specifies the number of the lost record to be typed. If omitted, 
only record n is typed. 

c specifies the smallest column number of the range of columns to be 
typed. The default value is 1. 

d specifies the largest column number of the range of columns to be 
typed. The default value is 140. 


[. ..;]TS[ ; ...] 


Types the contents of the record currently open for editing under control of an 
SE, SS, or ST command. 

Option: 

The dots indicate that other commands may be present on the line. 


TS n[-m][,c[,d]] 


Types the contents of specified columns of one or more records beginning at 
record n. 

Options: 

Same as for the TC command. 


[. ..,]TY[;...] 


Types the sequence number and contents of the record currently open for editing 
under control of an SE, SS, or ST command. 

Option: 

The dots indicate that other commands may be present on the line. 


TYn[-m][,c[,d]] 


Types the sequence numbers and the contents of specified columns of one or 
more records beginning at record n. 

Options: 

Same as for the TC command. 


[. . . »Iij/itrinfl/Y[;. . .] 


Causes the remainder of the commands on the same line (and any continuations) 
to be executed only if the specified string is found in the edit record. (Inde- 
pendently determined for each record in the edit range. 

Option: 

] specifies the Jth occurrence of the string. Otherwise, the first 
occurrence is sought. 
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14. TERMINAL JOB ENTRY 



Terminal Job Entry (TJE) provide* real-time-shared computing 
service that allows multiple on-line terminali to be eon- 
meted to the central computer. There ore three general 
categories of time-sharing service provided to on-line users. 
They are on-line file management, on-line multi-task; exe- 
cution and debugging, and on-line entry of jobs into the 
batch stream. Some of these services are provided by pro- 
cessors that are listed in Table 24 and are discussed in i 
derails in the following paragraphs. 



MUST 

MUST is a multi-use service translator which is a subset of 
RADEDIT and allows for file and peripheral manipulation. 
It may be used to allot, delete, truncate, dump, or map files 
and areas. It may also serve to copy files or devices to one 
another. 



Table 24. On- Line User Processors 



Processor 


Function 


TEL 

EDIT 

MUST 


Executive language control of all terminal 
activities. 

Composition and modification of programs 
and other bodies of text. 

General file and peripheral utility. 



TERMINAL EXECUTIVE LANGUAGE 

The Terminal Executive Language (TEL) is the principal ter- 
minal language for CP-R. Most activities associated with 
FORTRAN and assembly language programming can be 
carried out directly in TEL through requests that take the 
form of single-line commands and declarations. These ac- 
tivities include such major operations as composing programs 
and other bodies of text, batching the programs, initiating 
execution of one or more concurrent tasks, and debugging 
these tasks. They also include such minor operations as de- 
termining batch status and setting simulated tab stops. 



EDIT 

The Edit processor is a line-at-a-time context editor de- 
signed for on-line creation, modification, and handling of 
programs and other bodies of information. All Edit data is 
stored on disk storage in a structure of sequence-numbered 
variable length records. 

Edit functions are controlled through single-line comma n ds 
supplied by the user. The command language provides for 
insertion, deletion, reordering, and replacement of lines or 
groups of lines of text. It also provides for selective print- 
ing, renumbering records, and context editing operations 
of matching, moving, and substituting line-by-line within 
o specified range of text lines. 



THE TERMINAL 

Under CP-R terminals are treated as devices in every sense. 
They may be assigned to operational labels, to DCBs, and 
by background control commands. Any job may assign to 
any terminal in any other job and communicate with it. 



TERMINAL OPERATIONS 

The types of on-line terminals used with TJE may be: 

Xerox Model 7015 Keyboard/Printer. 

Teletype Models 33, 35, and 37. 

Any terminal compatible with any of the above. 

In addition to these remote terminals supported through use 
of Xerox communication equipment, local teletypes (e.g., 
TYndd) may be used with TJE. Since local terminals are not 
processed by the communications handler only these functions 
avaiable by the local teletype handler are available to the 
local teletype user. (See LOGON, CONTROL and BREAK 
key-ins.) 

The following sections describes the totality of remote ter- 
minal support (see Figure 28) without delineation of those 
functions not available to local terminals. 

Six facets of terminal operations are described in this sec- 
tion. They are 

1 . Initiating and ending on-line sessions. 

2. Typing lines. * 

3. Typing commands. 

4. Detecting and reporting errors. 

5. Interrupting CP-R. 

6. Paper tape unit. 
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LTD These keys pre mining on some models. 

[2] This key Is positioned elsewhere on some models. 



Q] This is interpreted as | (OR) on Model 7015. 
GQ This is interpreted as — I (NOT) on Model 7015. 



Characters obtained by depressing the SHIFT key are shown at the top of the key and characters obtained by depressing the CTRL key are shown at the 
bottom of the key. Characters obtained by depressing both SHIFT and CTRL keys are shown above the key. On the actual keyboard, oil unparenthesized 
forms appear at the top of the key. 



B 



Figure 28. Model 33 Teletype Terminal Keyboard 



■ffUTWC AMD ENOHW MI4ME KSSIOM 

An on-line user must establish a connection with CP-R and 
identify himself properly before he can use TEL or any of the 
processors. When a connection with CP-R is established, 
CP-R responds by typing 

XEROX CP-R AT YOUR SERVICE 
ON AT (time and date) 
LOGON PLEASE: 



The system then waits for user account and 
tared in the following format: 



to be 



account,name 



Account must be from one to eight characters and the name 
must be from one to twelve characters in length. Any of 
the following characters may be used in user account and 
name: 

A-2 a-z 0-9 _$*%:'<§)- backspace 

Underscores count as characters and print as left-facing 
arrows (—). Commas are used as separators. After name 
is entered, the RETURN or LINE FEED key is depressed to 
return the carriage to the left margin of the next line and 
to deliver the line to CP-R for examination. 

For terminals operated in full-duplex mode, character echo- 
ing by the system is normally on but can be turned off (e.g., 
to suppress printing of passwords or other security-related 
information) by striking the © E keys. Striking the © E 
keys a second time turns echoing back on. For terminal 
units operated in half-duplex mode, character echoing by 
the system must be turned off, as above, to suppress dupli- 
cate printing of characters. 

If the identification is valid and consistent with CP-R rec- 
ords, the user gives the job identification, TEL types its 
prompt character (I) at the left margin, and then awaits the 
first command. The system sends an error message to the 
terminal and repeats the log-on request if the identification 
is garbled or otherwise invalid. The error messages are 

? under the field in question 

account,name ? ? 

It may not always be possible to log on. If an error prevents 
the log-on, the message LNxxx yy or TYndd yy (e.g., 
LN0Q7 66) will be typed, where N yy u (i.e., 66) represents 
a type completion. Depending on the error, the user may 
be logged off immediately or allowed to try again. The sys- 
tem tries five time to log each user on before dismissing 
him. Note that an error message of this type may appear 
anytime during a user's session due to various reasons (e.g., 
lock of space) causing an immediate log-off. 

Following a successful log-on, the user will receive the fol- 
lowing message: 



An on-line session is ended by entering the OFF command. 
The system sends the following information to the terminal 
when a user logs off: 

I ITERMINAL JOB {j^d } oeeount,nome OFF 

Note that "LNxxx or TYndd" not only identifies the user's 
terminal, but also the user's job. 



TVPIN6 LINES 

The rules governing the typing of lines are concerned with 
operations such as erasing characters or lines, terminating 
lines, pagination, tabbing, and so on. These rules are com- 
mon to TEL, all subsystems, and programs that carry on a 
line-by-line dialogue with the user. 



PROMPT CHARACTERS* 

When a connection is first established between a terminal 
and the computer, a message is sent to the terminal request- 
ing the user to log on. As soon as the user has logged on, 
TEL types a prompt character at the left margin of the next 
line to indicate that requests may be entered. Thereafter, 
a prompt character is sent to the terminal following a com- 
pleted request, an error, or an interruption by the user. If 
the services of a processor are requested, the processor iden- 
tifies itself with a different prompt character. 

The prompt characters used by TEL and all on-line processor 
are as follows: 

TEL I 

EDIT • 

MUST 

ECHOING CHARACTERS - ESC E 

For terminals operated in echoplex (full-duplex) mode, char- 
acter echoing — display on the terminal's output device of 
characters typed in — by the system is normally 'on 1 , but can 
be turned off, and on again, etc., at the user's discretion 
(e.g., to suppress printing of passwords or other security- 
related information). Successive uses of the ESC E key se- 
quence toggles the echoplexing on/off state. For terminal 
units operated in local-printing (half-duplex) mode, charac- 
ters typed at the terminal are automatically printed by the 
terminal. When operating in local-printing mode, the user 
will need to turn echoplexing off to avoid redundant echo- 
ing by the system. (In half-duplex, a direct electrical con- 
nection exists between the keyboard and printer, via the 
unit.) 



1 ITERMINAL JOB (^JJJ) account ,name 



ON 



See M:PC Service Call, Chapter 5. 
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ERASING CHARACTERS - RUBOUT OR ESC RUBOUT 



TYPING AHEAD 



Depressing the RUBOUT key (or the ESC RUBOUT sequence) 
erases rhe last unerased character. The system responds by 
yping a backslash (\) to indicate that it has effectively 
backspaced and erased. On terminals that can backspace, 
backspacing does not erase. Thus, it is possible to over* 
strike characters as well as to erase them. 



COC routines allow 'type-ahead' operations. Key strokes 
(or paper tape frames) that are input by the user before the 
system requires them will be retained until an M:READ is 
issued. 



SIMULATING TAB STOPS - ESC T 



ERASING THE CURRENT INPUT LINE - ESC X 

The current input message (one line or less) is erased by de- 
pressing the two keys ESC and X sequentially. If an input 
operation is pending, the system types a left-facing arrow 
or underscore, returns the carriage to the position at the 
beginning of input on the next line, and returns control to 
the user without further comment. The current message may 
then be entered. 



CANCELLING ALL INPUT AND OUTPUT - CONTROL X 

Depressing the CONTROL and X keys simultaneously will 
cause all input (including messages typed ahead) and all 
output to be deleted. If an input operation was pending, 
additional action is identical to that for ESC X above. 



RETYPING THE CURRENT LINE - ESC R 

When the ESC R sequence is received, the carriage is re- 
turned to the position at the beginning of input on the next 
line and all characters accumulated will be retyped by the 
system. The user is then allowed to complete the message. 



ENTERING MULTILINE RECORDS - LOC RET, ESC LINE 
FEED OR ESC RET 



The user can enter tabulation characters into his terminal 
input, either with the CONTROL and I key combination 
or ESC I sequence on teletypewriter units, or the TAB key 
on terminal units that have it. The system simulates tabbing 
by typing (echoing) successive blank characters. Tab-stop 
values for this simulation can be set or changed by the TABS 
command. This tab simulation is under the user's control: it 
is 'on* at the beginning of a terminal session and set 10, 19, 
37, but the user can turn it off, and back on again, with 
the ESC T key sequence (!>•., successive use of the ESC T 
sequence has a toggle-switch effect on tab simulation, each 
use reversing the previous on or off state). With tab simula- 
tion on, any tab characters either sent from the terminal or 
received for transmission to the terminal are replaced at the 
terminal by an appropriate string of blanks (in lieu of me- 
chanical tabulation). If no tab- s top values are set, each 
tab character is replaced by a single blank. The state of tab 
simulation does not determine whether or not blanks are sub- 
stituted for a tab character in the input stream received by 
the processor or program requesting the input. 

SIMULATING TAB CHARACTERS-ESC I AND CONTROL I 

The ESC I and CONTROL I sequence are treated exactly as 
a tab character. This function is provided for terminals that 
are not equipped with a TAB key. 

SETTING THE TAB RELATIVE MODE - ESC C 



On a terminal unit having an inherent line-width limit of 
less than 140 (e.g., Teletype Models 33, 35, and 37), a 
single, multiline record may be entered in either of two 
ways: 

1 . Using the local carriage return key marked LOC RET, 
if present, to "break 1 * the input line without releasing 
it to the system. 

2. Using the simulated local carriage return sequence 
ESC RET or ESC LINE FEED for the same purpose. 



TERMINATING LINES 

When TEL or a processor that carries on a line-by-line di- 
alogue is in use, an "end-of-messoge " is signaled by de- 
pressing either the RETURN or LINE FEED key. ESC and 
then F signals "end-of-file". Each read operation at the 
terminal specifies a maximum number of characters to be 
read (never more than 140) . If this number is reached, 
"end-of-messoge H is signaled. TEL read operations are re- 
stricted to a maximum of 80 characters. 



Normally tabs are considered to be physical carriage posi- 
tions. If the tab relative mode is active, tabs on input are 
considered to be offset from the position of the carriage at 
the beginning of input. 

The tab relative mode is toggled on or off by the ESC C 
character sequence. The tab relative mode is initially set 
to OFF. 

RESTRICTING INPUT TO UPPER CASE - ESC U 

When the character pair ESC U is received, a flag that con- 
trols alphabetic characters is toggled. When set, all lower 
case letters received am translated to their upper case 
counterparts. "* « 

INTERPRETING UPPER CASE AS LOWER CASE - ESC ) 

Receipt of the ESC ) sequence causes 

1 . All subsequent upper case alphabetic characters to be 
interpreted as the corresponding lower case alphabetic 
characters. 
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2. The terminal characters @[\]^_ to be Interpret e d as 
' {-.]- DEL respectively. 

This remains In effect until the ESC ( sequence ts received. 
The parentheses are echoed, thus bracketing the characters 
that were interpreted as upper ease. This feature is pro- 
vided to enable terminals that are upper case only to input 
lower case characters. 



EXITING THE LOWER CASE INTERPRET MODE - ESC ( 

The ESC ( character sequence removes the effect of the 
ESC ) sequence (described previously) . 



TYPING COMMANDS 

Except for a few declaratives/ commands take the form of 
imperative sentences. They consist of an imperative verb 
followed by a direct object or list of objects. Indirect ob- 
jects usually follow a preposition but may follow the verb 
with elision of the implied direct objects. Minor variations 
of this structure are expressed as encoded parenthetical! 
following either the verb or one of the objects. Individual 
elements of a fist of objects are set off from one another by 
commas. 

Common rules of composition are applicable to commands. 
Words of the language, numerals, object identifiers, and 
other textual entities may not be broken by spaces. Other- 
wise, spaces may be used freely. For purposes of scanning 
commands, both by machine and by human eye, this rule has 
a simple interpretation. Leoding spaces are skipped over in 
a left-to-right scan for the next syntactic element of a 
command, and trailing spaces are treated as terminators for 
words, numerals, and other textual entities. 



DETECTING AND REPORTING ERRORS 

The primary object of the error detection procedure is that 
user information should not be destroyed by an attempt to 
execute a command that cannot be carried through to com- 
pletion. To ensure that each command is at least formally 
valid, TEL and all subsystems that carry on a line-by-line 
dialogue always parse an entire command before starting on 
operation. 

Error messages sent to a terminal are as terse as possible 
since the majority of errors are easily found once the 
fact that an error exists has been brought to the atten- 
tion of the user. 



MTERRUPTMG CP-R 

CP-R can be interrupted whenever one of its processors or a 
user task Is in control . Subsequent control depends on which 
interrupt keys are used and which processor or user program 
h in control . 



CONTROL Y, ESC Y, OR ESC ESC 

Regardless of what program is in control of the keyboard, 
the operation can always be interrupted by simultaneously 
depressing the CONTROL and Y keys (or by typing the 
ESC Y sequence or the ESC ESC sequence). The system re- 
sponds by stopping the current operation as soon as there is 
a convenient breakpoint and turning control over to TEL. 
All input received prior to this key-in that has not yet been 
read by the program will be erased. 



BREAK 

If a processor or a task explicitly requests break control, the 
task can be interrupted by depressing the BREAK key. This 
action gives control to the task that has explicitly asked for 
it(seeM:INT). 

A succession of four or more BREAK signals always returns 
control directly to TEL. There are two reasons for this 
return to TEL. First, some actions can only be stopped at 
points of convenience and others have so much inertia they 
cannot be stopped at all. Second, machine or program er- 
rors may have disabled the program's response to the BREAK 
signal. However, it must be emphasized that depressing the 
BREAK key one time does not constitute a preemptive request 
for the services of TEL as does depressing the CONTROL and 
Y keys (or the ESC Y or the ESC ESC sequence). 

The precise handling of interruptions by processors is defined 
by the processors. The handling of interrupts by object pro- 
grams is defined by the calls these programs can make on 
system services. If the user does not have break control, 
interruption of an object program always causes a return to 
TEL. In general, interruption of the system or any of its 
processors results in termination of the current operation as 
soon as possible and return of control to the user after the 
appropriate prompt character has been typed. 



ESCQ 

Teletype users may request acknowledgment from the system 
at any time by use of the ESC Q sequence. The system will 
respond by sending two exclamation points (I I) to the termi- 
nal . No other action is taken by the monitor. - 



The error messages and actions initiated by the errors are 
contained at the end of each chapter for the processor 
to which they apply. 



'See MdNT Service Call, Chapter 5. 
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PAPER TAPE MPUT 

Paper tape may be punched off-line on Teletype terminals 
-nd subsequently read on-line after the user hat logged on 

d a xompt for data on the tape hot been ittued. The 
tame characters thai are keyed in during on-line input may 
be punched into paper tape. The procedure for reading 
paper tape on-line is at fellows: 

1 . Insert the, paper tape in the paper tape reader. 

2. Depress the X-ON (Q c ) key. Thit will start the 
reading of the tape by the paper tape reader under 
control of the computer. 

3. Depress the X-OFF (S c ) key to turn off the paper tape 
mode (read operation). 

Rubout characters are ignored during a paper tape read 
operation. This enables the uter to use rubout characters 
to delete unwanted characters as in normal paper tape 
operation. 

The paper tape read mode is set when a DO character 
(X-ON) is received from the Teletype. It it reset (to nor- 
mal processing) when a DC3 character (X-OFF) is received. 
Characters that are input through the keyboard while the 
Teletype is in the paper tape mode are normally received 
after the reader reaches the end of the tape or the tape 
is removed from the reader. 

Restrictions: 

1. Line feed (LF) characters received after any other 
activation condition is reached are ignored. 

2. The full duplex paper tape facility requires the X-ON, 
X-OFF option on the Teletype. 



HALF DUPLEX PAPER TAPE READING MODE 

A special mode is available for half duplex terminals that 
are reading paper tape . VA\\ le in thit mode, no attempt is 
made by the monitor to turn the tape reader off or on. Input 
is accepted until available buffer space is exhausted. No 
program output, prompt characters, or echoes are tent to the 
terminal because the mode renders the terminal incapable 
of accepting output . 

The half duplex paper tope mode it entered upon receipt of 
an ESC P sequence or upon receipt of an X-ON character 
while in the nonechoplex mode (controlled by ESC E). The 
mode is exited by a balancing ESC P sequence or by an 
X-OFF character if it was initiated by X-ON. 



Table 25. Summary of Teletype Services 



Function 


Key-in 


Get log-on message 


BREAK 


Erase line 


ESCX 


Tab relative 


ESCC 


Suppress lowercase 


ESCU 


Uppercase shift 


ESC( 


Lowercase shift 


ESC) 


Erase last character 


RUBOUT 


Tab 


ESC 1, CONTROL 1 


End of input 


NL, RETURN 


Line continuation 


ESC CR, ESC LF, LOC CR 


Retype 


ESC R 


Toggle tab simula- 
tion mode 


ESCT 


End of file 


ESC F 


Monitor escape 
(to TEL) 


ESC ESC, CONTROL Y, ESC Y, 
or 4 BREAKs 


Break 


BREAK 


Half duplex paper 
tape 


ESCP 


Toggle ECHO mode 


ESCE 


Acknowledge 


ESCQ 


Erase all input and 
output 


CONTROL X 



SUMMARY OF TELETYPE FUNCTIORS 

Table 25 summarizes the function* of Teletype terminals. 



TERMINAL EXECUTIVE LANGUAGE 

Once account verification and log-on have been accom- 
plished, the uter It in control of hit own foreground job which 
contains one task, TEL. The name of the job and the name 
of the terminal which has logged are identical. TEL initial- 
izes the tab settings to 10, 19, and 37 and assigns all appro- 
priate operational labels for the job to the terminal. Once 
prompted by TEL the user may begin hit activities. These 
activities include: 

Major operations 

Composing program and data files. 

Loading tasks and initiating execution. 

Initiating debugging operations. ,. 

Creating multi-task environment. 

Submitting batch Jobs. 

Calling previously submitted batch jobs. 

Calling processors. 

Interrupting, continuing, and terminating execution. 
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Minor operations 
Logging off. 

Assigning operational labels. 
Setting simulated tab stops. 
Stopping and starting tasks. 
Terminating tasks. 



This command has the form 

TABS iM-.-M 
where s is a column position where a tab stop is to be placed. 



OFF This command indicates that the user is done. All 
tasks associated with this terminal job will be aborted. 



MAJOR OPERATIONS 

An AP or FORTRAN program may be composed on-line by 
the Edit processor, which is called by the EDIT command. 
The resultant file may be submitted for assembly and loaded 
to the batch system . 

After successful batching the resultant load module may be 
executed by use of RUN or INIT. Both primary and second- 
ary may be created at any level, with or without time shar- 
ing. Thus a user may create and control any multi-task 
structure desired. 

Debugging activities are initiated by starting the execution 
of a load module under control of the debugging processor, 
DEBUG. DEBUG is most appropriate!/ used for debugging 
Meta-Symbol programs but may be used for debugging any 
program. It may always be called into association with an 
executing program for aid even after execution has begun. 

An executing program becomes a static module whenever it 
is interpreted or whenever an error occurs. This static core 
module con then be restarted with the CONTINUE or GO 
command. 



MINOR OPERATIONS 

The user may assign operational labels, stop and start tasks, 
previously created with INIT, or terminate these tasks. He 
may also set tab settings or terminate the entire job by log- 
ging off. 



ERROR HANDLING 

Whenever a syntactical error occurs, TEL outputs a "?" un- 
der the offending field. If the syntax is correct but an error 
occurs subsequently, a "xx?" is output; where, "kx" repre- 
sents the type completion. 



TEL COMMANDS 

TABS This command permits up to 12 simulated tabs, in 
ascending sequence to be set. Whenever a tab character 
(Control I) is received from a terminal, spaces are tent to 
the terminal to position the carrier to the next stop. These 
spaces are also given to the reading p rogram. 



MESSAGE This command causes a message to be sent to 

the machine operator. 

This command has the form 

MESSAGE text 

where text may be from 1 to 50 characters. 



STDLB The assignment thus invoked is permanent for this 
terminal job. 

This command has the form 



STDLB label, 



device 

fid 

oplabel 



where 



label specifies one of the standard operational 
labels as defined at SYSGEN. C and OC may not 
be reassigned. 

device specifies a device name to which the opera- 
tional label is to be assigned (e.g., 9TA81). 

fid is a CP-R file identifier for a file to be assigned 
to the label. 



MEDIA This command will cause the file to be listed on 

the list device presently assigned. 

This command has the form 

MEDIA fid 

where fid is a CP-R file identifier. 



BATCH This command causes the file to be entered into 
the symbiont input queue of batch jobs to be run. 

This command has the form 

BATCH fid 
where fid Ii a CP-R file Identifier. 

A batch file may contain only one background job. 
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( 



JOI This command coums the statu* of the botch Job to 
be output. 

Tlii* command has the form 

JOB identification 

where identification it the hexadecimal value returned by 
BATCH. 

»■ 
CANCEL This command causes the batch job to be 

cancelled. 

This command has the form 

CANCEL identification 

where identification is the hexadecimal value returned by 
BATCH. 

SETNAME This eommandestablishesorcancels a relation- 

ship between a task name and a file name for the terminal 
job which uses it. Whenever an INIT service is requested 
for the SETNAMEd task, the related file name is used as the 
load module name for the task . The number of relationships 
which may be established is limited by the JPT parameter of 
the SYSGEN RESERVE command. 

This command has the form 

SETNAME taskname[, load module] 
where 

taskname is a 1 to 8 character name. 

load module is a 1 to 8 character name. If omitted/ 
the currently established relationship for 'taskname' 
is cancelled. 



Op] 



This command causes the load module to be loaded 
in core and if requested, gives control to DEBUG, and if 
not, gives control to the program. Note that the command 
RUN need not be included and is thus implied. 

This command has the form 

[RUN] task?d[UNDER DEBUG] 

where 

taskid is a CP-R file identifier for the file which 

contains the desired load module, it has the non- 
standard default of system processor (or system 
processor alternate) area and system account, if 
neither area nor oceount are specified. Other 
defaults are standard. 

DEBUG identifies the assembly language debugging 

system. 



Note that the RUN command always produces a synchronous 
stream of tasks. That is, all tasks run In the some task in 
which TEL runs. See INIT for asynchronous tasking. 



WIT This command causes the load module indicated to 

be loaded in core and either it or DEBUG will be given con- 
trol. The task thus initialized runs asynchronous to the TEL 
task (I.e., it is independent of the TEL task). 

This command has the form 

,NIT [sECONDARy] talk!d tA T PRIORITY, value] , 

L— [UNDER debug] 



where 



PRIMARY or SECONDARY defines the task being 

initialized as either a hardware dispatched task or 
a software dispatched task, respectively. The de- 
fault is SECONDARY. 

taskid is a CP-R file identifier for the file which 

contains the desired load module. If no equiva- 
lence has been established via SETNAME, ta sk name 
is the load module name. 

value is a 2 or 4 character hexadecimal field for 

SECONDARY task initialization only. The first 
2 characters are the interrupt level minus X'4F' 
of the dispatcher level to be used. The last two 
characters represent the software level within the 
dispatcher level. Softwore priority values X'FO 1 — 
X'FF* are reserved. If the PRIORITY value is not 
included, the task being initialized will run at the 
same level as that executing TEL. All tasks will 
be time sliced as are the TEL tasks. 

DEBUG identifies the assembly language debugging 
system. 



DEBUG This command causes the nomed task to be 

placed under DEBUG control. Only one task in the terminal 
job may be associated with DEBUG. 

This command has the form 

DEBUG [taskname] 

where taskname is a 1 to 8 character name associated with 
the task via INIT. DEBUG may be used without the op- 
tional parameter to activate debug in a synchronous task 
(stated with RUN). * 



EXIT This command causes the TEL task to exit. The TEL 
task will not be activated again until a TEL activation se- 
quence is executed from the terminal. This allows the other 
tasks in the job to use the terminal input facilities in a non- 
ambiguous manner. An implicit ex it is done for the DEBUG 
command or for an INIT command with a DEBUG option. 
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STOP r Wertf itfio so concory task froin further execution. 

START Allows a previously STOP'ed task to continue 
execution . 

The form of the STOP and START co m m an d is 

where taskname is t to 6 characters name associated with 
the secondary task via I NIT. 



EXTM This command causes the named task to be aborted. 

This command has the form 

EXTM taskname 

where taskname is a 1 to 8 character name associated with 
the task via RUN or IN1T. 



CATALOG 
jCOPY 

^DPCOPY 

£ND 

The command formats may be round in the RADEOIT chapter. 

To ease on-line usage, the user will have an optional syn- 
tactical variation available. All occurrences of '(', '), (', 
or ')' may be replaced by one or more spaces. For example, 



:ALLOT (F1LE,D3,TEST),(FSIZE,50) 



or 



jALLOT RLE,D3,TEST FSIZE^O 
are both acceptable. 

MUST is called by the RUN command by: 

I MUST 



QUIT This command maybe executed when TEL control is 
received from a task initiated via RUN (i.e., synchronous). 
It causes the program to be aborted. 



CONTINUE tt 60 These commands may be executed 

when TEL control is received from a program initiated via 
RUN (i.e., synchronous). They cause the program to con- 
tinue execution. 



MTERRUFTMK. RESUMING. AND TERMINATING EXECUTIONS 

Any processor or user program running synchronously with 
the TEL task may be interrupted by use of Yc. Upon inter- 
ruption, all TEL commands are legal except RUN. Before 
another run may be entered, QUIT must be used. 

MUST OPERATIONS 

MUST is a proper subset of RADEOIT. Only those co m mand s 
inappropriate for on-line use an unavailable. The follow- 
ing commands are available: 

^ALLOT 
^DELETE 
TRUNCATE 
jCLEAR 
jDUMP 
*DMP 
^MAP 
jLMAP 
:SMAP 



T£ ACCOUNT MAINTENANCE 

The system manager is responsible for maintaining the AI file 
in the SP area which contains all legal log-on accounts. 

The file must be blocked, sequential, and contains 80-byte 
records. 

The file must be maintained with Edit and contain line num- 
bers in columns 73-80. 

The file must be arranged alphabetically with one record per 
account and multiple subaccount records per account record. 

An account record contains the account number beginning in 
column 1 (e.g., K173021). 

A subaccount record, which must immediately follow the ac- 
count record, contains the account and subaccount separated 
by a comma (e.g., K173021, AB32). 

For example : 



Column 

i l I < i i ii t w mi o 



A 9 5 2 
A 9 5 2 
A 9 5 2 



C32105 2 

N 5 6 3 



K 1 7 3 2 1 ' 4 



K 1 7 3 2 1 
K 1 7 3 2 1 
K 1 7 3 2 1 



A B 3 2 
X 9 . . 
Z Z Z . 



Ti U J5 » TT ft 7? so 

. . all .000 
...2.000 


10 





. 4 
. 5 

1 
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STANDARD SYMBOLS. CODES AND CORRESPONDENCES 



STANDARD SYMBOLS MID COOES 

The symbols listed here include two types: graphic symbols 
and control character*. Graphic symbols are displayable 
and printable; control characters are not. Hybrids are SP 
(the symbol for a blank space), and DEL (the delete code) 
which is not considered a control command. 

Two types of code are also shown: (1) Table 26, CP-R 8-bit 
Computer Code, i.e., the Xerox Extended Binary-Coded- 
Interchange Code (EBCDIC); and (2) Table 27, CP-R 7-bit 
Communication Code, i.e., American National Standard 
Code for Information Interchange (ANSCII) . 



2. ANSCII (Table 27). 

64- ch a rac ter set: uppercase letters, numerals, space, 
and! "$%&'()* + , - • /\ ; : = 
< > ? @ _[] ~ ' |-» 

95-character set: same as above plus lowercase letters 
ondH!~' 



CONTROL CODES 

In addition to the standard character sets listed above, the 
Xerox symbol repertoire includes 37 control codes and the hy- 
brid code DEL (hybrid code SP is considered part of all char- 
acter sets). These are listed in Table 28, CP-R Symbol-Code 
Correspondences and Table 29, ANSCII Control-Character 
Translation Table. 



STANDARD CHARACTER SETS 

1. EBCDIC (Table 26). 

57-character set: uppercase letters, numerals, space, 
and &-/. <>() + !$•:;, 
% * @ ' = 

63-character set: same as above plus d I ? 



89-choraeter set: same as 63-character set plus lower- 
case letters. 



SPECIAL CODE PROPERTIES 

The following two properties of all Xerox standard codes 
will be retained for future standard code extensions: 

1. All control codes, and only the control codes, have 
their two high-order bits equal to "00". DEL is not 
considered a control code. 

2. No two graphic EBCDIC codes have their seven low- 
order bits equal . 
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Tabic 26. CM 8-Bit Computer Cedes (EBCDIC) 


















Most Significant Digits 




Hen 


odecimal 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 




Binary 


0000 


0001 


0010 


0011 


0100 


0101 


0110 


0111 


1000 


1001 


1010 


1011 


1100 


1101 


1110 


1111 


M 

'» 
5 

c 


o 

E 

"c 

a 

M 

s 

_l 





0000 


NUL 


DLE 


LF 

only 


ESC 
F 


SP 


& 


- 


': ■ 










SP 




- 





1 


0001 


SOH 


X-ON 


FS 


CAN 






/ 




a 


• 

1 




\' 


A 


J 




1 


2 


0010 


STX 


Da 


GS 


ESC 
X 










b 


k 


I 


r 


B 


K 


s 


2 


3 


0011 


ETX 


X-OFF 


RS 


ESC 
P 










c 


1 


t 


»■ 


C 


L 


T 


3 


4 


0100 


EOT 


DC4 


US 


ESC 
U 








- . 


d 


m 


u 


[• 


D 


M 


U 


4 


5 


0101 


HT 


LF 

NL 


EM 


ESC 
( 










« 


n 


V 


}■ 


E 


N 


V 


5 


6 


0110 


ACK 


SYN 


/ 


ESC 
) 










f 


o 


w 




F 


O 


W 


6 


7 


0111 


BEL 


ETB 


A 


ESC 
T 










9 


P 


X 




G 


P 


X 


7 


8 


1000 


EOM 
BS 


CAN 


= 


ESC 
S 










h 


q 


Y 




H 


Q 


Y 


8 


9 


1001 


ENQ 


EM 


CR 
only 


ESC 
E 








• 


i 


r 


z 




1 


R 


Z 


9 


A 


1010 


NAK 


SUB 


EOT 


ESC 

c 


2 


1 


~1 




















B 


1011 


VT 


ESC 


BS 


ESC 
LF 


. 


$ 


9 


# 


















C 


1100 


FF 


FS 


) 


X-ON 


< 


• 


% 


@ 








[• 










D 


1101 


CR 


GS 


HT 


*OFF 


( 


) 




1 








]' 










E 


1110 


SO 


RS 


LF 
only 


ESC 
R 


+ 


t 


> 


s 








Lostl 

Data 










F 


1111 


SI 


US 


SUB 


EsC 

CR 


i 1 


2 


? 


■1 






•l 


_,• 


. 






DEL 



Notes: 



1 The characters **\\ } [ ] ore ANSCII characters that do not appear in any of the Xerox EBCDIC-based character sets, 
though they are shown in the EBCDIC table. 

2 The characters / I - 1 appear in the Xerox 63- and 89-character EBCDIC sets but not in either of the Xerox ANSCII- 
based sets. However, Xerox software translates the characters 4 I - linto ANSCII characters as follows: 

EBCDIC = ANSCII 



i 

I 



* (6-0) 
! (7-12) 
- (7-14) 



3 The EBCDIC control codes in columns and 1 and their binary representation are exactly the same as fnose in the 
ANSCII table, except for two interchanges: LF/NL with NAK, and HT with ENQ. 

4 Characters enclosed in heavy lines are included only in the Xerox standard 63- and 89-charoeter EBCDIC sets. 

5 These characters are included only in the Xerox standard 89-character EBCDIC set. 

6 The EBCDIC codes in column 3 are used by COC to perform special functions. The EBCDIC codes in column 2 and 
positrons AF and BC through BF are used by COC for output only. 
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Table 27. CfMt 7-Bit Communication Codes (ANSC1I) 



Notes: 













Most Significant C 


liflits 








Decimal 

(rows) (col's.)— 





1 


2 


3 


4 


5 


6 


7 




1 


Binary 


xOOO 


xOOl 


xOlO 


xOll 


xlOO 


xlOl 


xllO 


xlll 


"5> 

'c 
o 
o 

*c 
m a> 
t^ 


« 





0000 


NUL 


DLE 


SP 





@ 


P 


% 


P 


1 


0001 


SOH 


DC1 


hp 


1 


A 


Q 


a 


q 


2 


0010 


STX 


DC2 


* 


2 


B 


R 


b 


r 


3 


0011 


ETX 


Da 


# 


3 


C 


S 


c 


s 


4 


0100 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


5 


0101 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 


6 


0110 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


7 


0111 


BEL 


ETB 


■ 


7 


G 


w 


S 


w 


8 


1000 


BS 


CAN 


( 


8 


H 


X 


h 


X 


9 


1001 


HT 


EM 


) 


9 


I 


Y 


i 


y 


10 


1010 


LF 
NL 


SUB 


* 


: 


J 


z 


i 


z 


1) 


1011 


VT 


ESC 


+ 


f 


K 


4 t 


k 


{ 


12 


1100 


FF 


FS 


t 


< 


L 


\ 


i 


1 
1 


13 


1101 


CR 


GS 


- 


= 


M 


'] 


m 


I' 


14 


1101 


SO 


RS 


• 


> 


N 


4>s 


n 


4 


15 


mi 


SI 


US 


/ 


? 


O 


4 


• 


DEL 



1 Most significant bit, added for 8-bit format, is either or an even-parity bit for the remaining 7 bits. 

2 Columns 0-1 are control codes. 

3 Columns 2-5 correspond to the Xerox 64-character ANSCH set. 
Columns 2-7 correspond to the Xerox 95-character ANSCH set. 

4 On many current teletypes, the symbol 

^ is t (5-14) * 

_ is-(5-15) 

~ is ESC or ALTMODE control (7-14) 
f is ESC or ALTMODE control (7-13) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences noted above, 
therefore, such teletypes provide all the characters in the Xerox 64-character ANSCH set. (The Xerox 7015 Remote 
Keyboard Printer provides the 64-character ANSCII set also, but prints"' as A . It also interprets the [] characters 
asl-l.) 
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Tabla 28. CMt Symbol-Cod* CorrtponUncmt 



EBCDIC' 


syiRboi 


Card Coda 


ANSCIl" 


Moaning 


Remarks 


Hex. 


Ok. 


00 





NUL 


12-0-9-8-1 


0-0 


null 


00 through IF ore control codes. 


01 


1 


SOH 


12-9-1 


0-1 


•tart of header 




02 


2 


STX 


12-9-2 


0-2 


•tart of text 




03 


3 


ETX 


12-9-3 


0-3 


and of text 




04 


4 


EOT 


12-9-4 


0-4 


and of trommtMion 




05 


5 


HT 


12-9-5 


0-9 


horizontal tab 




06 


* *■ 


ACK 


12-9-6 


0-6 


acknowledge (mitiva) 




07 


7 


•EL 


12-9-7 


0-7 


ball 




06 


8 


BSorEOM 


12-9-8 


0-8 


baclapaca or end of message 


EOM is used only on Keyboard/ 


09 


9 


ENQ 


12-9-8-1 


0-5 


enquiry 


Printers Models 7012, 7020, 8091, 


0A 


10 


NAK 


12-9-8-2 


1-5 


negotive ocknow ledge 


ond8092. 


OB 


11 


VT 


12-9-8-3 


0-11 


vortical rob 




OC 


12 


FF 


12-9-8-4 


0-12 


form food 




OD 


13 


CR 


12-9-8-5 


0-13 


carriage return 


CR outputs CR and LF. 


OE 


14 


SO 


12-9-8-6 


0-14 


shift out 




OF 


15 


SI 


12-9-8-7 


0-15 


»hift in 




10 


16 


OLE 


12-11-9-8-1 


1-0 


data link escape 




11 


17 


DC1 


11-9-1 


1-1 


device control 1 


On Teletype terminals, DC! is X-ON. 


12 


IB 


DC2 


1 1-9-2 


1-2 


device control 2 




13 


19 


DC3 


1 1-9-3 


1-3 


device control 3 


OC3 isRSon 2741s, X-OFF on Teletypes. 


14 


20 


DC4 


11-9-4 


1-4 


device control 4 




15 


21 


LFor NL 


11-9-5 


0-10 


line feed or new line 


LF outputs CR and LF. 


16 


22 


SYN 


11-*-6 


1-6 


sync 




17 


23 


ETB 


11-9-7 


1-7 


end of transmision block 




IB 


24 


CAN 


11-9-8 


1-8 


cancel 




19 


25 


EM 


1 1-9-8-1 


1-9 


ana of medium 




1A 


26 


SUB 


11-9-6-2 


1-10 


substitute 


Replaces characters with parity error. 


IB 


27 


ESC 


11-9-8-3 


1-11 


escape 




tc 


28 


FS 


11-9-8-4 


1-12 


file separator 




10 


29 


GS 


11-9-8-5 


1-13 


group separator 




IE 


30 


RS 


11-9-8-6 


1-14 


record separator 




IF 


31 


US 


11-9-8-7 


1-15 


unit separator 




20 


32 


IF only 


11-0-9-6-1 


1-5 


line feed only 


20 through 2F are used by COC for 


21 


33 


FS 


0-9-1 


1-12 




output only. These codes are 


22 


34 


GS 


0-9-2 


1-13 




duplicates of the label entries 


23 


35 


RS 


0-9-3 


1-14 




that caused activation. The 


24 


36 


US 


0-9-4 


1-15 




20-2F entries output o single code 


25 


37 


EM 


0-9-5 


1-9 




only and ore not affected by any 


26 


38 


/ 


0-9-6 


2-15 




special COC functional processing. 


27 


39 


1 


0-9-7 


5-14 






28 


40 


M 


0-9-8 


3-13 






29 


41 


CR only 


0-9-6-1 


0-13 


carrioge return only 




2A 


42 


EOT 


0-9-8-2 


0-4 






2B 


43 


•S 


0-9-8-3 


0-8 






2C 


44 


) 


0-9-8-4 


2-9 






20 


45 


HT 


0-9-8-5 


0-9 


tab code only 




2E 


46 


LFonly 


0-9-8-6 


1-5 


line feed only 




2F 


47 


SUB 


0-9-8-7 


1-10 






30 


48 


ESCF 


12-11-0-9-8-1 




end of fi le 


30 through 3F cause COC to perform 


31 


49 


CANCEL 


9-1 




delete all input and output 


special functions. 


32 


50 


ESCX 


9-2 




delete input line 




33 


51 


ESCF 


9-3 




togs Is half-duplex paper tope mode 




34 


52 


ESCU 


9-4 




toggle restrict upper case 




35 


53 


ESC( 


9-5 




upper case shift 




36 


54 


ESC) 


9-6 




lower case shift 




37 


55 


ESCT 


9-7 




toggle tab simulation mode 




36 


56 


ESCS 


9-8 




toggle space insertion mode 




39 


57 


ESCE 


9-8-1 




toggle echo mode 


* 


3A 


58 


ESCC 


9-6-2 




toggle tab relative mode 


3B 


59 


ESCLF 


9-8-3 




line continuation 




3C 


60 


X-ON 


9-8-4 




start paper tope 


* 


30 


61 


X-OFF 


9-6-5 




stop paper tape 




3E 


62 


ESCR 


9-8-6 




retype 




3F 


63 


ESCCR 


9-6-7 




line continuation 




Hexodecimo 


and decimal 


notation. 








Decimal noti 


Jtion (column- 


row). 
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TobU 28. CP-R Symbol-Cod* Cerntpondmnemt (coot.) 



EICDIC* 


Syfinol 


Card Coda 


ANSC1I M 


MfjoninQ 


Itemorfcs 


Hex. 


Dec. 


40 


64 


SP 


blank 


2-0 


blank 




41 


65 




12-0-9-1 






41, 43, 46, end 47 or* unotsigned. 


42 


66 




12-0-9-2 








43 


67 




12-0-9-3 








44 


68 




12-0-9-4 








45 


69 




12-0-9-5 








46 


70 




12-0-9-4 








47 


•71 




12-0-9-7 








48 


72 




12-0-9-8 








49 


73 




12-8-1 








4A 


74 


*«' 


12-8-2 


6-0 


cant or occant grove 




48 


75 


. 


12-8-3 


2-14 


pariod 




4C 


76 


< 


12-8-4 


3-12 


toss than 




4D 


77 


( 


12-8-5 


2-8 


toft parenthesis 




4E 


78 


+ 


12-8-6 


2-11 


plus 




4F 


79 


lor! 


12-8-7 


7-12 


vortical bar or brokon bar 




50 


80 


& 


12 


2-4 


ampersand 




51 


81 




12-11-9-1 






. 


52 


82 




12-11-9-2 








53 


83 




12-11-9-3 








54 


84 




12-11-9-4 








55 


85 




12-11-9-5 








56 


86 




12-11-9-6 








57 


87 




12-11-9-7 








58 


88 




12-11-9-8 








59 


89 




11-8-1 








5A 


90 


1 


11-8-2 


2-1 


exclamation point 




5B 


91 


$ 


11-8-3 


2-4 


dollar* 




5C 


92 


• 


11-8-4 


2-10 


asterisk 




5D 


93 


) 


11-8-5 


2-9 


right parenthesis 




5£ 


94 


i 


11-8-6 


3-11 


semicolon 




5F 


95 


~or — 1 


11-8-7 


7-14 


tildo or logical not 




60 


96 


- 


11 


2-13 


minus, dash, hyphen 




61 


97 


/ 


0-1 


2-15 


slash 




62 


98 




11-0-9-2 








63 


99 




11-0-9-3 








64 


100 




11-0-9-4 








65 


101 




11-0-9-5 








66 


102 




11-0-9-6 






63, 65, 68, ond 69 are unauigned. 


67 


103 




11-0-9-7 








68 


104 




11-0-9-8 








69 


105 




0-8-1 








6A 


106 


/\ 


12-11 


5-14 


circumflex 


On Model 70 1 5 "• is A <coi»0 . 


68 


107 


* 


0-8-3 


2-12 


comma 




6C 


108 


% 


0-8-4 


2-5 


percent 




60 


109 


- 


0-8-5 


5-15 


underline 


Underline is sometimes called "brook 


6E 


110 


> 


0-8-6 


3-14 


greater than 


character"; may be printed along 


6F 


111 


? 


0-8-7 


3-15 


question mark 


bottom of character line. 


70 


112 




12-11-0 








71 


113 




12-11-0-9-1 








72 


114 




12-11-0-9-2 








73 


115 




12-11-0-9-3 








74 


116 




12-11-0-9-4 






73, 75, 77, and 78 are unaalgned. 


75 


117 




12-11-0-9-5 








76 


118 




12-11-0-9-6 








77 


119 




12-11-0-9-7 








78 


120 




12-11-0-9-8 








79 


121 




8-1 








7A 


122 




8-2 


3-10 


colon 


4 


78 


123 


* 


8-3 


2-3 


nunbor 


«k 


7C 


124 


@ 


8-4 


4-0 


at 




70 


125 


■ 


8-5 


2-7 


apostrophe fright tingle quote) 




7E 


126 


m 


8-6 


3-13 


•quo Is 




7F 


127 


m 


8-7 


2-2 


quotation mark 




Hexadecima 


and decimo 


notation. 








Decimal noti 


jtion (columr 


^ow). 
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Tafela 28. 


C*~R Sywbot~Cod« Conwpoodanc** (coot.) 


EBCDIC* 


symbol 


Card Cod* 


ANSC1I* 


Moaning 


Roieui ki 


Hex. 


Dec. 


ao 


128 




12-0-8-1 






80 is unouigned. 


81 


129 


a 


12-0-1 


6-1 




81-89. 91-99, A2-A9 compriu the 


83 


130 


b 


12-0-2 


6-2 




loworeos* olphobet. Avoi table 


83 


131 


c 


12-0-3 


6-3 




only in irondord 89- ond 95- 


84 


132 


d 


12-0-4 


6-4 




choroctar tett. 


85 


133 


• 


12-0-5 


6-5 






86 


134 


f 


12-0-6 


6-6 






87 


135* 


e 


12-0-7 


6-7 






88 


136 


h 


12-0-8 


6-8 






89 


137 


< 


12-0-9 


6-9 






8A 


138 




12-0-8-2 






8A through 90 or* unouigned. 


88 


139 




12-0-8-3 








8C 


140 




12-0-8-4 








8D 


141 




12-0-8-5 








8E 


142 




12-0-8-6 








8F 


143 




12-0-8-7 








90 


144 




12-11-8-1 








91 


145 


j 


12-11-1 


6-10 






92 


146 


k 


12-11-2 


6-11 






93 


147 


I 


12-11-3 


6-12 






94 


148 


m 


12-11-4 


6-13 






95 


149 


n 


12-11-5 


6-14 






96 


150 


e 


12-1 !-• 


6-15 






97 


151 


» 


12-11-7 


7-0 






98 


152 


S 


12-11-8 


7-1 






99 


153 


r 


12-11-9 


7-2 






9A 


154 




12-11-8-2 






9A through Al or* unouigned. 


98 


155 




12-11-8-3 








9C 


156 




12-11-8-4 








9D 


157 




12-11-8-5 








9E 


158 




12- 11 -8-* 








9F 


159 




12-11-8-7 








AO 


160 




11-0-8-1 








AJ 


161 




11-0-1 








A2 


162 


I 


11-0-2 


7-3 






A3 


163 


t 


11-0-3 


7-4 






A4 


164 


u 


11-0-4 


7-5 






A5 


165 


V 


11-0-5 


7-4 






A6 


166 


w 


11-0-6 


7-7 






A7 


167 


X 


11-0-7 


7-8 






A8 


168 


Y 


11-0-8 


7-9 






A9 


169 


X 


11-0-9 


7-10 






AA 


170 




11-0-8-2 






AA through AE an unouigned. 


AB 


171 




11-0-8-3 








AC 


172 




11-0-8-4 








AD 


173 




11-0-8-5 








AE 


174 




11-0-8-6 








AF 


175 


1 


11-0-8-7 




logical and 


AF it und by COC for output of 
on ANSCH 7-12 coda only. 


80 


176 


\ 

I 


12-11-0-8-1 








81 


177 


12-H-O-l 


5-12 


bedalosh 




82 


178 


12-11-0-2 


7-11 


loft brace 




83 


179 


12-11-0-3 


7-13 


right bract 




84 


180 


[ 


12-11-0-4 


5-11 


loft bracket 


On Model 7015, T it 1. 
On Model 7015, J it— |. 


85 


181 


J 


12-11-0-5 


5-13 


right brocket 


86 


182 




12-11-0-6 








87 


183 




12-11-0-7 






BO and B6 through BB ore unouigned. 


88 


184 




12-11-0-8 








89 


185 




12-11-0-9 








8A 


186 




12-11-0-8-2 








88 


187 




12-11-0-8-3 






« 


BC 


188 


[ 


12-11-0-8-4 




raft brodttft 


BC, BD, and BF ore weed by COC for 


BO 


189 


] 


12-11-0-8-5 




right brocket 


output of ANSCH 5-11, 5-13, and 


BE 


190 


lot dots 


12-11-0-8-5 




Icetdoto 


7-14, rotpecrivoiy. 


BF 


191 


—l 


12-11-0-8-7 




logical nor 




Heasjdeciiml 


and decimal 


notation. 








UwCiwoi note 


Hon (column 


-row). 
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Toblo 28. CMt Symbol-Cod* Corrospondancw (eont.) 



EBCDIC* 


Symbol 


Card Cod* 


ANSCn M 


PMVOAf ftQ 


whwihi 




Hex. 


Dee. 


CO 


192 


SP 


12-0 


2-0 


blank 


Outpu- only. 


CI 


193 


A 


12-1 


4-1 




C1-C9, D1-D9, E2-E9compr. M 


the 


C2 


194 


B 


12-2 


4-2 




uppercase alphabet. 




C3 


195 


C 


12-3 


4-3 








C4 


196 


D 


12-4 


4-4 








C5 


197 


E 


12-5 


4-5 








C6 , 


198 


F 


12-6 


4-6 








C7 


199 


G 


12-7 


4-7 








C8 


200 


H 


12-8 


4-8 








C9 


201 


I 


12-9 


4-9 








CA 


202 




12-0-9-8-2 






CA through CF or* unassigned. 




CB 


203 




12-0-9-8-3 










CC 


204 




12-0-9-8-4 










CO 


205 




12-0-9-8-5 










CE 


206 




12-0-9-8-6 










CF 


207 




12-0-9-8-7 










DO 


208 




11-0 






DO is unostigned. 




Dl 


209 


J 


11-1 


4-10 








D2 


210 


K 


11-2 


4-11 








D3 


211 


I 


11-3 


4-12 








D4 


212 


M 


11-4 


4-13 








D5 


213 


N 


11-5 


4-14 








D6 


214 


O 


11-6 


4-15 








D7 


215 


P 


11-7 


5-0 








D8 


216 


Q 


11-8 


5-1 








D9 


217 


R 


11-9 


5-2 








DA 


218 




12-11-9-8-2 






DA through DF art unouigned. 




DB 


219 




12-11-9-8-3 










DC 


220 




12-11-9-8-4 










DD 


221 




12-11-9-8-5 










DE 


222 




12-11-9-8-6 










DF 


223 




12-11-9-8-7 










EO 


224 


- 


0-8-2 


2-13 


minui 


Output only. El it unouigned. 




El 


225 




11-0-9-1 










E2 


226 


S 


0-2 


5-3 








E3 


227 


T 


0-3 


5-4 








E4 


228 


U 


0-4 


5-5 








E5 


229 


V 


0-5 


5-6 








£6 


230 


W 


0-6 


5-7 








E7 


231 


X 


0-7 


5-8 








E8 


232 


Y 


0-8 


5-9 








E9 
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Z 


0-9 


5-10 








EA 


234 




11-0-9-8-2 






EA through EF or* unouigned. 




EB 


235 




11-0-9-8-3 










EC 


236 




11-0-9-8-4 . 










ED 


237 




1 1-0-9-8-5 










EE 


238 




11-0-9-8-6 










EF 


239 




11-0-9-8-7 










FO 


240 








3-0 








Fl 


241 


1 


1 


3-1 








F2 


242 


2 


2 


3-2 


• 






F3 


243 


3 


3 


3-3 








F4 


244 


4 


4 


3-4 








F5 


245 


5 


5 


3-5 








F6 


246 


6 


6 


3-6 








F7 


247 


7 


7 


3-7 








FB 


248 


8 


8 


3-8 








F9 


249 


9 


9 


3-9 








FA 


250 










4 




FB 


251 














FC 


252 














FD 


253 














FE 


254 




12-11-0-9-8-6 






FE it not assigned. 




FF 


255 


DEL 


12-11-0-9-8-7 


. 


delate 


Special —neither graphic nor 
control symbol ■ 




Hexadecimal and decimal notation. 






Decimal notation (column-row). 
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Table 29. ANSCII Control-Character Translation Table 







Input 


Output 


ANSCII 


TTY 
Key 


Echoed 


Prog. Receives 
(EBCDIC) 


Process 


EBCDIC 


Transmitted 
(ANSCII) 


NUL(D0) 


P e$ 


None 


None 


None 


NUL (00) 


Nothing (end of 
output message). 


SOH (01) f 


' AC 


SOH 


SOH 


None 


SOH (01) 


SOH 


STX (02)* 


B c 


STX 


STX 


None 


STX (02) 


STX 


ETX (03)' 


C c 


ETX 


ETX 


None 


ETX (03) 


ETX 


EOT (04)» 


D c 


EOT 


EOT 


None 


EOT (04) 


EOT 


ENQ (05)' 


E c 


ENQ 


ENQ (09) 


None 


HT(05) 


Space(s) if tab 
simulation on, or 
HT(09) if not. 


ACK (06) f 


F c 


ACK 


ACK 


None 


ACK (06) 


ACK 


BEL (07) 


G e 


BEL 


BEL 


None 


BEL (07) 


BEL 


BS (08) 


H c 


BS 


BS 


None 


BS(08) 


BS 


HT (09) 


I c 


Space to tab stop if 
tab simulation on, 
or 1 space if not. 


Spaces to tab stop, 
or one space, or tab 
(05) depending on 
space insertion mode. 


None 


ENQ (09) 


ENQ (05) 


LF/NL (0A) 


NL 


CR and LF 


LF (15) 


Input Complete. 


NAK (OA) 


NAK (15) 


VT (0B) 


K c 


VT 


VT 


None 


VT(0B) 


VT 


FF(0C) 


L c 


None 


FF 


Page Header 


FF(0C) 


Page Header 


CR(0D) 


CR 


CR and LF 


CR (0D) 


Input Complete. 


CR (0D) 


CR and LF (0A) 


SO(0E) 


N c 


SO 


SO 


None 


SO(0E) 


SO 


SI (OF) 


O c 


SI 


SI 


None 


SI (OF) 


SI 


DLE (lO)' 


P C 


DLE 


DLE 


None 


DLE (10) 


DLE 


DC1 (11) 


Q c 


DC! 


DC! 


None 


DC1 (11) 


DC1 


DC2 (12) 


R c 


DC2 


DC2 


None 


DC2 (12) 


DC2 


DC3 (13) 


S c 


DC3 


DC3 


None 


DC3 (13) 


DC3 


DC4 (14)* 


T e 


DC4 


DC4 


None 


DC4(14) 


DC4 

CR and LF (0A) 


NAK (15)' 


U 6 


NAK 


NAK (15) 


None 


LF/NL (15) 


SYN (16)' 


V* 


SYN 


SYN 


None 


SYN (16) 


SYN 


ETB (17) f 


W« 


ETB 


ETB 


None 


ETB (17) 


ETB 


These charae 
patibility witr 


hen are con 
i future hor 


imuni cation control cha 
aware developments am 


meters reserved for use 
i is done so by the user 


by hardware. An 
at his own risk. 


f other use of 


them risks incom- 
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Table 29. ANSCII Control-Character Translation Table (coot. ) 



Input 


Output 


ANSCII 


TTY 
Key 


Echoed 


Prog. Receives 
(EBCDIC) 


Process 


EBCDIC 


Transmitted 
(ANSCII) 


CAN (18) 


X e 


Back-arrow 
ondCR/LF 


None 


Cancel input 
or output 


CAN (18) 


CAN 


»■ 








message. 






EM (19) 


Y« 


Bock-arrow 
andCR/LF 


None 


Monitor Escape/ 
Control to TEL. 


EM (19) 


EM 


SUB (1A) 


2 C 


SUB 


SUB 


None 


SUB (1A) 


'(A3) 


ESC (IB) 


K c, 

ESC 
PREFIX 


None 


None 


Initiate escape 
sequence mode. 


ESC (IB) 


ESC 


FS (1C) 


L« 


FS 


FS 


Input Complete. 


FS (1C) 


FS 


GS (ID) 


M« 


GS 


GS 


Input Complete. 


GS (ID) 


GS 


RS(1E) 


N« 


RS 


RS 


Input Complete. 


RS (IE) 


RS 


US (IF) 


O" 


US 


US 


Input Complete. 


US (IF) 


US 


t(7D) 


ALT- 
MODE 


| or None 


for None 


f if model 37; as 
ESC if model 33, 
35, or 7015. 


f(B3) 


}<7E) 


~(7E) 


ESC 
(7015) 


— or None 


~or None 


—if model 37; as 
ESC if model 33, 
35, or 7015. 


i(5F) 


~(7E) 


DEL (7F) 


Rubout 


\ 


None 


Rubout last 
character. 


DEL (FF) 


None 


All ANSCII upper and low 
sponding EBCDIC graphics 
shown, allowing for Table 
Lower case alphabetic! mo 
it set. Upper case alphab 
set. 


rer case alphabetics 
as shown in Tables 
26, Note 2, and tr 
p into correspond; m 

etics map into cone 


are translated on input 
26 and 27. All specia 
le exceptions above for 
B EBCDIC upper case if 
sponding EBCDIC lowei 


into the corre- 
graphics map as 
model 33 and 35. 
the ESC U mode 
■ case if ESC) is 


Alphabetic and symbol output 
translation is also as shown in 
Tables 26 and 27; for Models 33 
and 35, and 7015 terminals, 
however, lower case alphabetics 
are automatically translated to 
upper cose. 
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15. SYSTEM GENERATION 



System generation adapts the CP-R system to the specific 
requirements of a user enviro n ment and configuration. The 
system generation process consists of four phases : BOOT26, 
SY5GENLOAD, SYSGEN, and SYSLOAD. 



B00T26 

Is a simple ROM bootstrap which only loads the SYS GEN- 
LOAD ROM from the some device as the original bootstrap. 



SYSGEMLOAD 

Is a more complex ROM loader which bods the SYSGEN/ 
SYSLOAO ROM. Setting SSW3 allows for the selection of 
a ROM source other than the bootstrap device. 



SYSGEN/SYSLOAD 

Is a single ROM, but runs as two separate processes. 



SYSGEN 

Reads control cards and constructs all system tables. It may 
either go directly into the SYSLOAO process, or it may out- 
put a rebootdble memory image which contains the SYSLOAD 
process and the constructed tables. Setting SSW3 allows the 
operator to select the command input and listing devices, 
otherwise default device addresses and types will be assumed, 
(see SYSGEN description). 



MEMORY ALLOCATION 

MEMORY LAYOUT AFTER SYSGEN 

AfterSYSGENhas executed and before control is transferred 
to SYSLOAO, memory has the layout displayed as fellows: 



Interrupts, traps, etc. 


320 

350 

4 

10K 
12K ^ 

15K 




Unused interrupt locations used 
for monitor tables 


Output in 
• Rebootable 


System flags and pointers 


CP-R tobies (DCT, IOQ, RFT, etc.) 
and dynamic space 


Deck 


Patch area 




CP-R overlay area (1 page) 




e 
e 




SYSGEN 




SYSLOAO 


Output in 
' Rebootable 


Symbol table 


Deck 



CP-R STRUCTURE 

The control program, or monitor, is assembled in several 
different modules, the largest of which consists of the fol- 
lowing nonoptional resident routines: 

I. CP-R Control Task. 



SYSLOAO 

Reads the system ROMs and forms the system on the system 
disk. Optionally, a map of both memory and disk allocation 
may be printed, (see SYSLO description). 

A sample map output by SYSGEN is illustrated in Figure 29. 

Control is transferred to SYSLOAD either following the 
completion of the SYSGEN operation or loading of the re- 
bootable SYSLOAD deck. 



Sense switch settings affect the way SYSGEN operates. 
These effects will be described under "Input Parameters". 



2. Control Panel Task. 

3. Tasks to process the various traps. 

4. The following monitor functions: Dynamic space man- 
agement, overlay manager, entry and exit logic, and 
general CAL exit/entry logic and L^O cqptrol. 

•4 

The other CP-R modules consist of the optional resident 
routines, the CP-R overlays, and the Job Control Processor 
(JCP). All CP-R is assembled as relocatable object mod- 
ules and loaded by SYSLOAD. 

The optional resident routines are the floating-point sim- 
ulation routines and decimal simulation routines; they are 
input during SYSLOAD as required. 
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I5ITE 550 PROTOTYPE 1 CP» DOO 


IPROC 


(*IOP, 22), («I0P. 21) 


IPROC 


("X*2<0,(»I,27) 


iproc 


(MIOP,0),(Ml,*),(PI.T».{CPU,5) 


IMONITOH 


(C0RE,6«)| 


t 


C8PAI,RI)| 


1 


(account, fb)j rn»E/8ACKCP0ijND accounting 


1 


(ERROR) 1 ERROR LOGGING 


t *■ 


(BOUND) i SOUND PESIOEMT OVERLAYS 


t 


(OLArEP, 1000)1 


1 


(CRASM)I CRASH SAVING 


1 


(DEBUG) » DE^uG CAPABILITIES 


1 


(REBDOT)I 


1 


(SSrLAv,i.OAO)l 


1 


(ROLAV, TRAPS) TRAP HODULE RESIDENT 


IRESFRVE 


(FFPCOL.2)! FOREGRCUNP BLOCKING POOLS 


1 


(TSPACE. 2000)1 


1 


(FRAp,lP)» 


t 


(BRAS, 10)1 


1 


(RSDF,1?,5800)» USE FOR PRIMARIES 


1 


(FIOO,lfl)| FOREGROUND lOfl ENTRIES 


1 


(6100,20)1 BACKGROUND 100 ENTRIES 


1 


(FMB0X.20); FOREGROUND mail BOXES 


t 


(BT.b)l BACKGROUND TEMP FILES 


1 


(MPATCl, 256)1 


1 


(TASKS, 15)1 MAXIMUM « OF TASKS 


1 


(JOBS, 10)1 MAXIMUM « OF JOBS 


1 


(JPT,2S)I 


1 


(JENQ,3)J 


1 


(TENQ,2)| 


1 


(TASKS, ?u) | 


1 


(LD*D,20) 


ICOC (DEVICE,A05),(LlNE3.7),(MARnNlRE,l,0) 


IC0HME*T 


RING BUFFER DEFAULTS TO 2*" OF LINES 


•COMMENT 


COCBUFFERS DEFAULT TO NUMBER OF LINES 


ICOMHENT 


INTERRUPTS DEFAULT TO 60 AND 61 AS IN AND OUT 


ICMAN 




IDEVICE 


TYA01,a592 


ICHAN 




IDEVICE 


LPA02.H65,(DF0ICATE,S) 


ICMAN 




IDEVICE 


CRA03. 7120, (DEDICATEES) 


ICHAN 




IDEVICE 


TVAOB,0591 


ICHAN 




IDEVICE 


9TAB0,3335 


IDEVICE 


4TA61,13aS 


IDEVICE 


9TA82,J3aT 


IDEVICE 


9TASl,33u5 


ICMAN 




IDEVICE 


DPAEO, 7270f 


1 


(SP, 2100)1 


1 


(CK,tt20}l 


1 


<D1,1«00,B)I 


1 


(BT,2U00)I 


1 


(13,20,50)1 


1 


(OS, 50,250)1 


1 


(FP, 1800)1 


1 


(BP,1S00)| 


1 


(05, ALL, B) 


IDEVICE 


OPAE1.7270 


ICMAN 




IDEVICE 


DPVC0,J2fll 


IDEVICE 


OPVCl.JJaJ 


IDEVICE 


DPVC2,I2al 
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IDFVICE 


U»VC3.S?«3 














iPEVICf 


DCVC6,I2l« 












• 


ICMAN 
















tDFVICE 


O»*P0.i283 














IC*AN 
















IDFVICC 


OP«Fi#i?77 














|C«A* 
















ICEVICE 


0***2, SMI 














ISTOLH 


(QC*TVA01)I 














1 


(LP»L*A021| 














1 
1 


CCP.CBA05)! 














(T0.9TAB0)! 














1 


(Tl#9TABl)| 














1 


(T2,9TAP2)I 














1 


(T3,9TABi)| 














1 


(C.CR)I 














1 


CLO»LP)l 














1 


(LL»LO)l 














> 


(DO,L")l 

(BUrTl)l 














1 


(5I,CP)I 














1 


(CI.CP)l 














1 


cai,T2); 














1 


(BI,T3)I 














t 


("O.LP)> 














1 


(OlfOC)l 














1 


(OLfLP)* 














1 


(Sk,Tl)» 














1 


(EP»0)| 














1 


(Pi»LP)» 














1 


<P2.LP)« 














1 


(DP,CP) 














ICTJNT 


(CT,6<n,r*i,6<n 














IIKTLH 


(10*62)1 














1 


(11,63)1 














1 


(I2#6«)l 














1 


(13.65)1 














1 


(I«f66) 














ULLOBT 


(6n,i0)i 














t 


(0V.20) 














ISVSLO 


(I*, 9TA83, 33u5)l 














1 


(maP,lp*02,3«6S)j 
(V.COO)f 














1 


(UPD) 














PITCH FKAaQteOO 














PMBOX FwA«0OOl« 














FGD, FfcA«05APC 














BCkG, F*A«0600C 














*••» CPB TABLE ALLOCATION **** 














DCTi 


■0064 OCT1P in06A 


PCTJ4 


■ 006A 


DCT2 


«007« 


DCTJ 


•007B 


DCTO 


■ 00B2 OCTDISCH0089 


PCTb 


■ OOflF 


0CT6 


■ 0095 


OCT7 


■ 009C 


DCTB 


■ 00A5 DCT9 «00B7 


DCTIO 


■ OOCA 


OCTM 


■ 0003 


OCT12 


■ 00E5 


OCT1S 


■ 00F6 CCTltt aOUC 


0CT15 


■ 0123 


0CT16 


■ 021* 


DCT17 


■ 0120 


DCT1S 


■0132 0CT1» ■0139 


OCT20 


■ 0?aE 


OCT20A 


■0253 


0CT21 


■ 0258 


DCTDEBUG»0262 OCTRBm «0267 


PCTOCB 


■ 026C 


OCTJID 


■0273 


. OCTMOO 


■ 0279 


DCTMODX 


•0293 PCT*If> «029C 


DCT*E«P 


«0?AF 


PCTS0BUF«02C«» 


DCTTJE 


■ 0203 


OCTSVHi 


■02DA DCTSVM2 «02DE 


OCTSVW3 


■ 02F1 


DCTCB 


■ 02F6 


DlSCfcSP 


T»02FB 


DI8CMHPSB02FD DI8C"AX3«02FF 


niSC»*IN5«030a 


DI8CSSFTV030A 


OISCTSFT»0rbC 


DISCCSFT«030E DISCMTPO031C 


PISC"C*I 


.■0313 


L0GFL4C 


■ 013E 


SITE 


■ 0316 


CNFGADD»«032« CNFGTvPE»0*27 


CNFGST»T«0329 


"OOCT1 


■ 0332 


HDOISCt 


■033S 


MOBOA 


■ 033B M0EO* a034i2 


MpFL»G 


■ 03«C 


MOMAM£ 


•03ar 


8I8P*I 


■0006 


SlISFSIZ»0032 8IQSFSIZ«00FA 


glJfcWQ 


■ 0003 


8ITENQ 


■ 0002 


St DEBUG 


■ OUO 


CIT1 


•0«DC CIT2 mono* 


CIT3 


«0*E2 


CITS 


•0«E5 


cm 


■ 0000 
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1001 

1007 

10012 

RFTi 

RPT6 

RFT11 

PFT16 

L*I1 

L"I»J 

L"ICTXT 

LHIRTS 

L«IUSE«S 

LHJRFT 

STIL^ID 

8TITIME 

STIQMiu 

B0LI*DD 

SJI1 

0PLB3 

XNTLB2 

OVIMA 

SlTPACE 

RHPT 

IOLOCK 

COlAOIL 

COiPCVOn 

COlLST 

COHHO 

■UFCNT 

MOOECPP 

COCII 

eoMTiMf. 

COlOUTO 

LNOL 
OLAYFWA 

*KLI*IT 

COCIMIT 

TEXSTCB 

MEORVFCA 

NEDRRB 

HCDRfASN 

MEDRPPTX 

MEDRBB2 

MMTSK9Q 

MMRT8 

MMPMAPL6 

MMRENDX 

KBKG 

■ CFPT 

•YMCOUNT 

8MSC7 

8MSC? 

8IZE08 

RCTIHER 

RCL08E 

RCASSIGN 

PPTSTIM 

FPTPOLBK 

FPTJOB 

OFLTP 

ADDRRtf 

0001FEOO 

Y69 
v» 

VJ 

YIC 



0«E8 

05)0 
0555 
05P2 

0681 
06C4 
0715 
079A 
07DP 
07F3 
082A 

085f 
0AA5 
0938 
0990 
0905 
09fc| 
09tC 
0A2A 

0A51 
08741 
OFEO 

offo 

100F 
1039 
103E 
1003 
1048 
1050 
105A 
1064 
1078 
1084 
0007 
1A00 
5030 
4151 
3A5<l 
3968 
39JA 
3910 
395C 
3919 
36F7 
36FC 
36A6 
3*45 
35DC 
3657 
3SE8 
3*0E 
35F6 
0028 
3645 
3638 
3628 
3SA0 
3588 
35A0 
3502 
35EC 
106F 
1DA2 
1096 
1098 
1090 



1002 

1008 

10013 

RFT2 

RPT7 

RFT12 

RFT17 

L.HIMAHE 

LHIJIB 

LMI5 

1*14 

STIS^CE 
8TIPRI0 
8TX0NXT 
8TI3HAX 

ROLILvLl 
SJZ2 

StSO 

0VL0A01 

OVIECB 

BlTRACEN 

PPT 

HMB0LTA8 

COIIIL 
COIXDATA 

COIRImCE 

COCHPB 

MODE 

COCTEft* 

COCIR 

COOiLPC 

COtCMMD 

COAlIIC 

LDPRE 

COCHTT 

TEX8TACK 

MEORTiSK 

MEDRRA 

HEDPJOB 

ME0RERP8 

NEORBBl 

HMTPREO 

MMRSTIME 

HMR^OOP 

MMA3T 

NC8TART 

MCDCB 

3V*B8TCB 

8M3C6 

8M8G1 

8XZEIS 

RCP08T 

RC6X0BLK 

RCAREa 

FPT8I6 

pptppiib 
fptoelf 

CK8I6 

AOORMSC 

ZE"08 

Y*8 

Y6B 

Y22 

Yl 



0«F0 
0517 
0572 
0629 
069E 
06E0 
071C 
079A 
0700 
0*0A 
0*58 
085F 
08&B 
093F 
09AE 
09DO 
09E9 
0«F6 
0A31 
0*54 
0BA8 
OFEE 
0FF7 
36A3 
103a 
103F 
1044 
1049 
1052 

tost 

1068 
107C 
108* 
0002 

50D0 
0003 
3AB5 
3916 
3932 
3912 
391 A 
3918 
36A1 
36F8 
36A7 
36EC 
3670 
3650 
3490 
3607 
35F0 
0018 
3642 
3620 
362E 
35B3 
3SC0 
35B1 
3689 
35EF 
1OC0 
IDA] 
1D9A 
1D9E 
1003 



1003 
1009 
10014 
•FT3 

RFTB 
PFT13 
BFTfcSZ 
L"I2 

l«ll>A 
IHI3TAT 

LHIMAXS 

l«ISECB 

8T1XBTS 

STITCB 

BTIR^XT 

•OLIPRIO 

R0LICRP1 

8JI3 

BlEOT 

OVL0A02 

OVTCT 

SlTRACES 

WLOCtt 

8IXBB 

COIOIL 

eniTR^DO 

C0MIRB8 

COCOC 

M00E2 

RSZ 

COCOI 

COOIH-L 

COCBUF 

COAIOIG 

LftPOBT 

TJEIWU" 

MEDRwB 

•»ED»STPS 

MEOROTHP 

MfORlTMP 

HEORCTRL 
WE0IARE8 
MMTPASE8 

MMRSPCSV 

XMRLEVEL 

XJOB 

NCSI6 

HC8UF 

SYMRSTAK 

S*SG5 

8HEMDAC 

8IZEFPTJ 

RCPOLL 

RCFPT 

RCACNT 

PPTPSTBK 

PPTOPEN 

FPTCR 

BFJJJlOO 

SCALL80 

V82 

Y6T 

V4 

Y2 

V0B1 



■ 04F8 


1004 »0500 


■ 0536 


X0010 S0546 


I05B0 


XOQECB «05B7 


• 0647 


RFT4 »0664 


• 06A6 


RFT9 «06AE 


■ 06FO 


RFT14 «0705 


■ 0738 


RFTE* «0755 


• 07C7 


LHIPCB «07C7 


■ 0700 


L*I4 «07F3 


• OSOA 


L"I6 «0815 


• 0858 


LMI9 *085E 


• 0863 


L^XRECB »0B79 


• 0808 


3TIRTSB ■06F4 


■ 095C 


STIOVID B097A 


■ 09B6 


STISTAT •098E 


• 09E5 


ROLXSrX B09E6 


• 09EA 


RDLII.VL2«09EB 


■ 0*12 


OPLBl »OAl* 


• 0A32 


ALARMREC«0A33 


■ 0A6fl 


OVISK aOAFO 


• 0C11 


FPIE» »0C2B 


■ OFEF 


8lTRACET«0FF0 


■ OFFE 


SlUTXHE «01F4 


■ 000ft 


COMiOM B1037 


• 103B 


COISTAT B103C 


• 1040 


COtRCvOO*l041 


• 10«5 


COlOUT «1046 


• 104* 


LBlUM «104C 


• 1054 


*0DE3 «1056 


• 10SE 


CPI •1060 


• 106C 


COCOR B1070 


• 107E 


COiXMO Bt«80 


• 108E 


MRBA 80050 


• 0002 


SlTE^PN »0910 


•512F 


COCOP »3EBB 


■ 3A51 


TJEl^OM B3A5? 


■ 3949 


MEOHWA B3942 


■ 3977 


MEPRSTCB«397C 


• 3917 


PEDR0DCB«3927 


•3916 


f*EDRlPAGB3A3B 


• 3910 


ME0RCHKt*«3954 


• 3910 


R0LL99 B36F6 


■ 36A0 


HHTBKGP «36A2 


• 36ED 


MMRPRJO B]6FA 


• 36F9 


MMRmoX ■36A4 


• 3509 


XFIN «35DA 


■ 3683 


MCJOBM B3640 


• 3658 


TESTACALB35C3 


■ 34C1 


8YMB «35ET 


• 3603 


SHSG4 «35FE 


• 3693 


8HCUP3 "3698 


'•0006 


SEX1 B3691 


• 363F 


RCPBIT8 «3633 


-3619 


RCOLTE «363C 


■ 3**1 


FPTWEOF "35BE 


'■3583 


FPTPR£CB«35CC 


■ 3598 


FPTLP »3558 


■3580 


FPTCL03 »359C 


l«3507 


§ATC«H8G«350E 


■2882 


494A4B «10BA 


• 1DA4 


Y8 B1000 


■ 1OA0 


V60 «109F 


■ 1001 


Y31 «1099 


■ 1O02 


V155A5A *1070 


• 108F 


YOB ■lDOfl 



1005 B05Q.8 
XODll B054F 
IOOFR«OR«05D5 
RFT5 «0673 
RFT10 B06B6 
RFT15 B0700 
RFTACMT «0762 
L»«IF»»A «07C7 
LMIPL «07F3 
L1IS0T »0815 
LMIMAXR B085E 
LMIAET B088F 
8TIJXD B0930 
3TICOUNT«0989 
8TXTXCX «09C6 
ROLITCB a09E6 

ROLXGRP2«09EC 
0PLB2 B0A23 
INTLB1 B0A4E 
0VL0A01 80859 
EPIB bOFEC 
SlTRACEP»OFFi 
StJPT B0019 
COIAIIL B103B 
COIOUTR5"103D 

coixsrnpBi042 

COHtXI B1047 

ARSZ •1Q4E 

M00E4 S1058 

CPOS B1062 

TL 81076 

COlINN aOOOO 

LCOC 80000 

SlTEMP «10F0 

COCXP 8JC4C 
TEXUOBKSOA50 
ME0RVFCB>3971 
HE0R8TAKB39A0 
MEDROC 83958 
ME0RX0CB8191C 
MEDRCMKR8J950 
NMT8LEV B36FB 
MMSTCB «36BC 
MMR0LMAP«36AB 
MHRCF|REa36BB 
XEXU 83506 
■CJOB «3649 
SYMCR8H 83613 
STOPHE 83557 
8HSC3 835FA 
8MtC 835E9 
SEXE1 83501 
RCOPEN 83636 
RCDCB 81610 
PPT8TME0«S5A6 
PPTPREC 835C7 
FPTJOBDL»35AB 
FMALL0T^368D 



tATCHF 

• CHAR 

Y7P 

V6F 

Y3830 

Y15 

V07 



35EA 
2E34 

1089 
1DA3 

1080 
109C 
1096 



Flatm 29. SYS GEN Map Example (conf. ) 



SYSLOAD 241 



J05 i 


• 1093 


V0« 


■ 100S 


VOl 


■1092 


Y008 < 


■ 1008 


V007F 


■ 1083 


V007 


■ 1080 


VOOS ' 


•108C 


Y002 


BlOOA 


Y0011 


■ 1088 


ypoo* « 


• 1084 


VQ002 


BlOOE 


YOOOA 


■1081 


YOOE i 


•1091 


vooc 


• 1090 


YOF 


■1097 


YFF8 « 


• 108* 


VFF7E 


B1085 


YFF4 


■ 1087 


yfffe i 


• 108*1 


VFF 


B1088 


YF 


■ 1DAA 


VC i 


• 1DA7 


VBE 


B10A5 


YA 


■ IDA* 


XBO i 


HOIS 


X8 


■ 103« 


X70 i 


■ 103E 


xtf •"■ 


UD27 


X7P 


■ ID3F 


X7 


■ 1023 


X* i 


HD38 


>5 


■ 1022 


X404040 I 


■ 1058 


X« i 


>1D10 


X380 


BlO*C 


X3000 


■ 104F 


IS i 


UD20 


X20200 


■ 1057 


X20000 i 


■moE 


X20 i 


•1011 


X2 


■ 101E 


X1R00 < 


■1D0E 


KIOOOO ■ 


>1D0F 


V1000 


• 1013 


XIO i 


■ 1D1B 


XI > 


»1D1F 


XFSOCMHObIDAD 


XF7 


■ 1047 


XFF7F I 


"1052 


XFFF7 


■ 1055 


XFFFO I 


■ 1054 


XPFFF i 


• 102C 


XFFFE 


■ 105* 


XFF 


■ 1D28 


XFB I 


■ lOa* 


XFC 


■ 104« 


vpe 


■ 1048 


xeo ■ 


• 1043 


XEF 


■ 1045 


XE i 


■ 103B 


XDF i 


>lDtt2 


XCF 


■ 1041 


X&F 


■ tt>40 


UTIMES I 


»1E39 


UTIME 


B1E38 


U3FC0" i 


■2E83 


TSlSTXCNi 


•21CE 


T81SEC 


B21C0 


TSTXGK i 


■21CC 


TIUP50 i 


HOCE 


TRAP4* 


■ 3074 


TRAP45 i 


■ 306A 


TMAP82 • 


■S04C 


TRAP4I 


■ 30U2 


TRAP40 i 


■ 3030 


TBAPX I 


■2FC7 


TRAP 


B302E 


TMjt5 i 


■23CR 


TMX1 « 


•23CE 


THVALF1 


■ 2454 


TMTRIG i 


■2410 


TMREECB ■ 


12091 


T«RDLTRG»2417 


TMENQGO i 


■ 247F 


TMOO i 


■2104 


TE"P 


B1DF2 


TOTRIG 


■ IE 38 


TDROIVL i 


■ 1E3* 


TOROLRETM20E9 


TOROLGP 


■ 1F37 


TA8K99 i 


• 1E11 


TllOEV 


B1F34 


8Y3ACNT 


■ 1F50 


BXGPOST i 


■ 2108 


8ER0EV 


B28A0 


SENSES* 


■2955 


SEGTPERBi 


•2787 


SDPSTAC««20CA 


80P05TER 


■2088 


ICI3EC i 


• 1E1C 


BCILIST 


bIEID 


SClIMXT 


■ 1E20 


•ClBBCH I 


• 1EIE 


RUN99 


BlElO 


R0LL98 


■1E12 


BESCHED < 


•28CB 


REOCOM 


■ 2BBF 


REPCOP 


■2E81 


•ELTEHPIi 


•12BE 


RELTEMP 


B12C0 


•ElENT 


■2F2F 


RBMSD i 


■1FB8 


RBmsavE 


■ 1FF5 


RBMEXITD 


■2008 


QUEUE « 


■2818 


QUANTUM 


■2100 


QSH4P 


■2102 


QMAX l 


•2101 


PU8HL0C 


B202E 


P08T10 


■27FA 


P0IT03 I 


•27F4 


P08T0S 


•27F2 


P03T01 


■27EF 


P0NP8D I 


• 10E4 


P0LLP0B7»21E1 


P0FFP80 


■ 10E8 


PFIP8D I 


■ 2F20 


0UTM8G 


B2D04 


OPTIONS 


■ 1E3S 


0MANFWA I 


H0S7 


OMAnFPP 


■ 14»D 


CHANPP 


■ 144F 


ececT i 


■2*58 


NEXTOUE 


B28F5 


«E««XOCK 


■2F8E 


m? i 


■ 1027 


M8 


■ 1028 


M5 


■ 1025 


Ml! < 


•ton 


HJ 


■ 1023 


«25 


■ 1O30 


Mi9 i 


• 1D2E 


HIT 


■ 1020 


"18 


■ 102C 


Ml I 


•1D1F 


HTPCPMD 


■ 10AC 


M8G9 


■2E2C 


MI64B l 


I2E17 


M3G4A 


■2E11 


M8G2 


■2E07 


MOVEBYTSi 


•23C5 


"FITRIP 


■2FAF 


"FIPSD 


■2F 14 


LOGSTACKi 


• 2D4E 


L48TPRTYB2F0A 


KEVBUF 


■12FC 


J0B99 I 


• 1E18 


JOBPRI 


■ 1E09 


JOB* 


■ 1E08 


IOICU i 


■2B37 


IOPSD 


■ 1004 


XOLOG 


■2C59 


IOCRA8H i 


■25A4 


20CL0CK 


• 1E0C 


TOALT 


■2A8C 


6T8L i 


• 32AB 


SOODLOGSB2080 


GINC 


■12A3 


•CTTfMP • 


•326C 


8ETP8IX 


■27B9 


GETPSX 


■27AF 


GETPI i 


•27A7 


GETP 


■2794 


6ETFPTW8 


■2780 


F7FFFFFFI 


• 1078 


FMRELRADB2755 


FMQUEUE 


■2*10 


FMABORT i 


•2787 


FXGPAMELB297A 


FGLTRXG 


■24*2 


F6LBIP l 


• 1E11 


FGDP8D 


• 1DD0 


Wflfffff 


■ 1D*A 


•FPFF800" 


■ 1D7B 


FFFFFF«0b1O5A 


FFFFFFE1 


■1070 


FFFFFEOOi 


• 1DS9 


FFFFFEFFBID80 


FFFFEFFF 


■10*1 


fFFOFFFF" 


• 10*4 


FFF0F0FFb10»3 


FFF0B5FF 


■1082 


FOFFFFFFi 


• 1078 


FCM7TDECB000E 


FCH7TBIN 


■ OOOB 


•CR7TOEC 


■ 0000 


FCR7TBXNB000* 


FCPOFFxt 


■ 0009 


fCRB*T i 


• 0002 


FCF8RMT 


■OOOS 


FCFBFMTI 


■ 0018 



V02 «100* 
YOO* *108E 
V001 «1D0R 
YOOFF «lD7r 
VOC "109* 
YFFFFFF »107C 
YE «1DA9 
X9 B1035 
X7FFFF «102E 
X8000 B10SO 
X4000 BiDll 
XIO B1D3C 
X2008 »1012 
X1700 «1040 
tirfPF «1020 
XFO B1D4* 
XFFFFOO B1D58 
XFE7D «1051 
XF B1D24 
KD80 B1039 
XB B103* 
TTICKS »21CF 
TRTN10 "312C 
TRAP4U B3060 
TRAP40 B30B* 
TMVO B23D1 
TWTPRIO B23FT 
TMOOR B21EA 
T0STLI0L»21TB 
TDRDL "20E2 
8YHREENTB1E1* 
8EEKA00RB2954 
•CE*0 B2288 
SClDCB B1E1F 
RIPTOFF B2fi(j 
RENTISN «1E14 
RCSO B2C0S 
RBMEXXTAB2007 
ORES BJ95A 
P08T07 BJ7F8 
POSTEOD B259* 
PL9EG8 "1E13 
0MANTPS0B3428 
0MANBPGSB1438 
M9 P1029 
MR «1024 
M28 •102F 
MIS B102B 
MSG* B2E28 
"SGI »2E05 
1.1015 B1DB* 
KIUTINE B1E3A 
JCBR8M B1F3E 
IOXNC B2910 
IMAGE B1ES2 
GETHD B237A 
6ETPS P2780 
GETFPTN 82784 
FMGETRA0B28SR 
PGLPUBL «1E34 
FF01FPFF»10*C 
FFFFFFEF»107! 
FFFFBFFF«1D*7 
FF0FEFFF»10*B 
FCNTMMT B0001 
FCRNT "0000 
FCFBFKT R0007 



Y01 B1D07 

Y004 B1009 

Y0008 B1DIC 

VOOFE B1DH2 

YOA 81095 

YFFFF .IP7E 

YD S10AB 

X8000 81010 

X7FFF B1D2B 

X80 8103D 

X40 81019 

X3F 8102* 

X200 8101* 
X1000001B105C 

X1FF B}029 

XFF8F B1D53 

XFFFFFF B102F 

XFE B1D48 

XE7 11044 

XD3600 8103* 

XA 81037 

TTFINAL B321F 

TRAP90 83! IE 

TRAP41 b305* 

TRAP4C 8309C 

TMK2 B23CF 
TM8ETERRB24ir 

TMDOA B21FE 

TD8TL 82130 
TDDX8PX 821C* 
8PRPS0 BiOEC 
8ECTPERNB278* 

8CIYEAR 81E1A 
BClOAY B1E1B 
RIPOFF 8297E 
MENTlO B1E15 
MC28 82CIF 
RBMEXXT 82003 
QMIN 82101 
P03TO* B27F* 
POST B27FC 
PFITRXP B2FAE 
0MANPAGE83438 
OMAN 8330C 
M8 81028 
M12 81032 
M2 81020 
M12 B102A 
M3G5 B2E23 
M8G0UT 82009 
L08TL06382081 
KIDPXDLEB2E28 
JCRBK6 B1F70 
IOERROR 82CA9 
GUTEMP 832B0 
6ETTEMPX832*A 
6ETPII 827B3 
6ETEFADRB27BD 
FMOELECBB2850 
FGLCBP Blf32 
FFFFTFFFBrt** 
FFFFFFBFB1075 
FFFEFFFFbID*5 
FEFFFFFFB1077 
PCWMT 80001 
FCREWMT BOOOB 
PCB8RHT ■0008 



R fl ur«29. SYSGENMapExan.pl. (cont.) 



242 SYSLOAD 



FCMFMTSS0015 


FCBSF**T ■0006 


F8FFFFFP«105D 


FBACC»T2«20B1 


FbACCNT18207F 




EXITA8BT«239E 


fXIT «239C 


EBP0R60 


827E0 


EHR0R59 «27E9 


EHP0R5B 


■27t7 




LMQPbu 


•27E3 


ERP0P«8 »27DF 


FRRO"«« 


■ 2700 


ERROPOfl '2709 


ERPOPAA 


■27E1 




EPR0R2E 


■27D9 


FRROR03 »2705 


FRPOR01 


82703 


ERROBCA »2707 


EOOREC 


■ 1045 




ENQPOST 


•23EA 


ENPAC «2C2fi 


EMRSECB 


■24E5 


EMPRECB "24C7 


EMP0STYC«2526 




EHPOST 


■250* 


Fm()ELECBb2(IAP 


FFFFFFF*«1P5F 


EDT99 BlEOF 


0IPECOPE81PC? 




DIOPSD 


■ 1008 


DFFFFFFF«107A 


RELCOM 


■2F81 


0EFFFF>F«1D79 


DCBLRR 


■ 2913 




DBG9REAK83t*E 


PATA1C10«1PC<» 


COOlFFFFalOfcD 


C0000030< 


■106E 


C0C0C0C0«lO72 




CVTFILE 


■25a« 


CVTDI8C »25C* 


CVTAREA 


■25H6 


CUP3PHSTS10F0 


CUPUCB 


■2PAE 




CUPCORE 


■2DA6 


cupcons »ino5 


C0PC0D3 


■ 1092 


CUPC0D2 «lf»06 


CUPC001 


■ 1007 




CTl 


■22«F 


CT8TCB «1FJC 


CTRTS 


■ 1E5C 


CTPIG «246F 


CTLSMB 


■2FF0 




CTI08TK 


■1E26 


CTALTPSt»«3«20 


CBSMXPSD«^328 


CRAS0LAYB2BBA 


CRASHRES«2950 




CPASM«EG«2B28 


CRASHPS0s2EBE 


CRASH««SG«2«ia 


CRA&MMAPS283S 


CHASML0C»295P 




CR45HIJ 


■ 2«a8 


CB*S*I2 b29«0 


CRASHI1 


•2939 


CPPS9 "lOOC 


C0UMT6S 


■ 1E0B 




C0UNT5S 


■ IEOA 


COUNTEBtiBlEOD 


COUNTlO 


■1E17 


CONVADPH«2701 


COMLIST 


■2E3B 




CLOC*PSD>1DEO 


CLK38AVEB1FF3 


CLK2SAVEB1FF0 


CL"flSAVE«lFtr> 


CKXA9T 


■ 10B4 




CFLAG 


■ 1FEC 


CCBUF BlFCE 


CAL234 


■ 1DBB 


CAL1PSP «10CC 


CALSTOX 


■2323 




C«LREG 


■ 1DF2 


CALLSD10B2B9C 


CALLSD 


■268H 


CALLOP ■25F7 


CALLO 


■ 25FU 




CALFLAG 


■ 1PAF 


CALEVTT B2331 


CALEPR 


■ 2325 


CALENTRY«3JEB 


BPKSl'B 


■2FD1 




BLANKS 


■ 10HE 


BNGSTOP B227C 


PKGSTARTB22B0 


SKALTPSOB300E 


BITABLE 


■ 1000 




BINITFP1 


r«ui9 


§FFFFFFF8lD7<t 


BC«*SHO 


■2F0B 


BALRRMSV810B2 


BAPCAL 


■2FC7 




• «•* CPf 


1 PPOGPAM ALLOCATION *•»* 














JCP 


■0EH8 


LOAD •0AB9 


TEL 


■ 0007 


FGL1 i 


cOOCA 


FGL2 


■ 0119 




FGL1 


■ 0135 


8C*ED lOUT 


8CNEXT 


■ 012* 


ABEX I 


•0U6 


KEYSCN 


■ OOED 




KEY1 


■ 01EF 


FEY2 «01C6 


KEY3 


■ OltO 


KEY4 1 


■ 0187 


KEY5 


■ 01F9 




KEY6 


• OIFB 


KEY7 aOOFB 


TE»1 


■ OlfcA 


TEX2 i 


»01F7 


TEL1 


■013S 




TEL2 


■ 0149 


TEL3 B0133 


DUMP 


a01E7 


BKL1 i 


10103 


ARM 


■ 01FE 




ENQ 


«01FF 


DELETE b01S» 


R-BFIL 


■017C 


FINDBB i 


10108 


OEVI 


• 0129 




ASSIGN 


■ 0132 


I0EX aOUO 


OPENX 


■ 010A 


CLOSEX i 


•Oil* 


REWIND 


■ 01F4 




REHDEV 


■ 0086 


IPL*" B0102 


IPLSY" 


■Oil* 


MMOl « 


• 01E8 


•»MR2 


■ 01FA 




««os 


• 01E2 


PM04 aOlFB 


"M05 


• OIFB 


MM06 1 


■014E 


PL01 


■ 016B 




SIGNAL 


■OIBS 


SJ06 aOlED 


SNAM 


■0101 


RUN i 


»0171 


PINIT 


■ 01F1 




• TOLB 


•01CS 


EXT* 80152 


WAIT 


■01C9 


TI01 i 


■013A 


TI02 


■ 016A 




TT 


■ 0150 . 


TTJOB »00F4 


JDP1 


■ 01EF 


J0B2 i 


I00C6 


8Y»<2 


• 01CB 




SYMJ 


■ 01F5 


8YM5 sOOAA 


TRAPS 


■ ttBAO 


TMGETP i 


»01«5 


*LLOT 


■OOFA 




ESU 


■ 01BF 


CR8 aOlBT 


CRO 


■ 0105 


CMP ■ 


■010A 


CK02 


■ 017E 




LOG 


■ 01FF 


CRASH bOOAP 


*EDl 


•01EB 


»*ED2 i 


'01FE 


CRS2 


•01FC 




OBOM 


•01CB 


DBC1 B01E6 


DBC2 


■oion 


0BC3 i 


• 01F3 


DBS1 


■01F0 




DBS2 


■ 01EF 


DBS3 bOIFS 


PRINT 


■01*1 


TMTYC i 


■4050 


CHECK 


B4F20 




REAOWR 


• 4720 


80BUF a«SF0 


BY* I 


• R960 


8Y»a i 


■4AB0 


RWFILE 


■4510 




RNOEV 


■43E0 


GETMRT a«B20 


DISC 


■5140 


TAPE i 


15680 


CARD 


85530 




TTY 


■5030 


MEOIA a3910 


LP 


■5410 


TEX i 


■ 3A50 


COCIO 


B3C30 




BEX 


• 3090 


TERM «4310 


TI03 


■ 3B20 


MHROOT « 


>36A0 


ABORT 


843C6 




ACTV 


• 1A2E 


ANALYSE alABl 


RKGSEO 


• 1AB6 


BKLASSN I 


• 1A39 


BREAK 


alASA 




CFUPDIR 


■ U87 


CHECKA BflFftS 


C*«B*L 


■4F35 


CHK6ALA I 


•4F33 


CKENACT 


84EB6 




CKENACTSattEB5 


CKENACTlBMEBA 


CKENACT2bbEBA 


eKINTADRi 


• 4EEF 


CKINTLAB»4EE* 




CLOSE 


■47ED 


CL0SEDCBBU7F1 


CLPSPFILalAflO 


COCRIP « 


>4270 


COCSPOV 


■42A1 


\ 


COCTI*E 


■ 0107 


COOP 84912 


CORRES 


■ 1AEB 


CPRSYMBL" 


■ 1A07 


CRFIL 


■ 1A6C 




CSEAP.CH 


■ 1A03 


DBKG alAB3 


PC8BU8Y 


•4756 


DEACTV i 


• l»2C 


DEBUG 


■ 1B9« 




OELFPT 


■ OF25 


PEO alA2(l 


OEVN 


■ 1A00 


DFGO • 


>1BDC 


PFGOBAL 


B1B03 




OFN 


■ UBE 


DISARM alAOO 


DRC 


■1B12 


OYF i 


■ 1B0B 


EMARECB 


■ 1B1F 




EMADECBXBIB1F 


EHBLDECBB1A7A 


EM0ATA1 


■1AC3 


EHPATAO • 


•IAEA 


EMGETECBB40CF 




EMGETE* 


■ 4DCB 


F*GETFPT«4DFB 


FMSETR3 


■S01B 


EM8ETR3AI 


•5019 


EMNAIT 


84E0B 




ENQABNM 


• 1AE« 


ENOCH* B1A8E 


ERR8END 


■1PB1 


FGLBADLMi 


•1A3C 


FGLMEMCKB1A3E 




FGL*SG 


■ 1A70 


FGLOKL* alA5B 


FINOOIR 


81A99 


FINDDIRXI 


• 1A9A 


FMBLDECBB48CF 




FMCMECK 


■ 4F*» 


FMCKMP 845C8 


F*CK1 


84FC4 


F»»c«2 i 


•4FC9 


FMCK3 


BflFCF 




FM0ELETE"iA3F 


FMJCL alABO 


FMMASTX 


■45DR 


FMPPL2A0I 


• 4843 


FHTCL * 


BlAFB 




FPTB8Y 


■a7Bi 


GENCMARSB1A57 


BtTANAM| 


[B1B86 


GETDCBAOi 


'4820 


GETDCTX-W482A 




GETIOIO 


■ 1A09 


GETTIME alBAC 


HOURLOC 


B1B39 


IbBPARANi 


•1B6E 


INITLOC 


81AC6 




XNSDBUF 


■ 4657 


JMTENQ B1AE3 


JMTERM 


■ IA22 


JOBOLTE i 


•1*0* 


JOBDLTEAB1A04 




J0BM8G 


■ 1A9F 


JOBSCAV 81B5E 


JSCAN 


■ 1B74 


JTRAP i 


• 4005 


KEYU04 


■ 1*11 




KJOB 


■ 1A76 


LOADACI bJ8«F 


LOAPMAP 


■ 384B 


LOGPURGEi 


•1B6F 


MEOIACAl 


.■1A67 




MEOIATSK«1AOO 


HEDRL00Pb3962 


ME0RLOPAB3970 


MEOR900 ■ 


•396] 


MEO0EXI1 


'■1B24 





Fl0ur« 29. SYS GEN AAop Lonpl* (coot. ) 



SYSLOAD 243 



NED090 ■ 


»1BJ0 


NED09« I 


■ IMP 


«ED099 i 


>1BS3 


«ED*>A0 1 


11*00 


MEOBOO i 


U*T5 


«D810 ■ 


>U5P 


MED82Q i 


■ l*DC 


MED830 ■ 


'I860 


ME08«0 t 


I1B6C 


MED880 ■ 


• 18** 


NMABNM ■ 


HABS 


MXACT i 


■ UB4 


*HC*l ' 


■ 1BB0 


NMCMECK i 


»U1F 


•<MDE*CT i 


• UK* 


pherase ■ 


U72 


MHEXEC ' 


■ 1*2* 


■ wmFETCM i 


I38BB 


MHFNP i 


• S7E« 


MMFOV 1 


• 149C 


RHGETP ■ 


1ACC 


HMGJPP I 


■ UES 


HMCP < 


H*3B 


MMGPPS 1 


■ UOO 


HM68TM I 


•3760 


rkctrp ■ 


1AE2 


*»*XCHK t 


■ 1*18 


mmLOC« < 


>1AQ5 


MMMOYE • 


>38CC 


HMOMFPP i 


'3BDC 


MMfOST ■ 


1RE2 


«*RDS i 


■ 1PB5 


MfRECB ■ 


■ 1BB7 


KMRELP « 


■ IBOR 


XMREL8 I 


• 1BEC 


HPREL8D ■ 


1BC« 


mmpfIlE i 


■ una 


MMRIL* * 


I37ED 


NMR18EG I 


i}«00 


. MHRJRP 1 


• 1940 


RMOll > 


tAOS 


MMR OL 1 1 Hi 


■ 1*23 


HHROUT I 


HAOO 


MHRP i 


■ 1*00 


NHRPPS 1 


• 1*73 


RHRPPM ■ 


U70 


MMRPREF i 


■ U33 


»MRRE*D I 


UR53 


MMRRFHEl 


■ 1926 


•IMRSTM I 


• 37*6 


RMTRP • 


1B3A 


MMPhRlTE" 


■ 1887 


MMS*C 1 


UAOO 


HH89S I 


UBAfl 


NHSEGCR i 


■ 1843 


MMSETVPNi 


1B*8 


HM3T*RT 1 


■ 1B2F 


t»M»TOP > 


■ 1*72 


MK8TORE < 


■ 38CR 


NM9NAP 1 


•38E8 


HM9MLK ■ 


HB8* 


MMTJ08 < 


■ 1BD1 


MMTPRIM 1 


UBH2 


"KTSEC « 


■ 1800 


KHUNLOCKi 


• UOO 


MMWPM a 


IBID 


MODIFY i 


■ 1*85 


PFFVERRG' 


■ 1B3R 


OMQFFMSG' 


■ UFO 


OPEW i 


■4705 


OPENDCB ■ 


47F6 


08E4RCM i 


■ U18 


OUTSDBUFi 


U5F1 


PFIL ' 


nun 


PFILOEV I 


■ U5C 


PlMTARNMi 


1838 


PMD 1 


■ 1*90 


POLL « 


»1*7B 


P0LL4BNHI 


■ 190C 


POLLCHK i 


■ U8F 


PPOST ■ 


1B0F 


PRECDEV i 


»i*«e 


PRECORO i 


• 1*23 


PREF»*OOEi 


■ UCO 


PROMPT i 


■ 1818 


PUBLI6 I 


HAOO 


R8L0CK i 


■ IPSO 


BCCUPF * 


■ 1*941 


PCCUPJ ' 


■ U88 


RCEXU i 


• 1*29 


rcfeoo ■ 


1A87 


RCGETF i 


■ 1*07 


RCJ08 i 


• l*«C 


RCOOP i 


■ii*8a 


READOIR i 


• 1BB5 


RECALARMi 


1890 


REL*D8UFi 


• U5C 


PETELI^Ci 


■ 1*0* 


RLS i 


■UCE 


RkRFILE i 


•0000 


KMUFXLE ■ 


0000 


SlOLC i 


■ 0000 


SCAN 1 


■ 1*8* 


SCFMPTV i 


■ 1*02 


SCFI^O ■ 


• 1*06 


IChEOC ■ 


0000 


8C»SG i 


■ 1*02 


8CUPDATEI 


UAA9 


8E*RCH*H 


■ 1*86 


SEGLOAO i 


• UEF 


•ETHANE ■ 


UOO 


8ET0VR i 


■ 4923 


8FTPRI i 


■ 1*7* 


SETUP i 


• lBCfl 


SIGABkM i 


• U51 


II6CHK ■ 


1*30 


SISN*Ll < 


■ 1*17 


STMIKEY i 


■ UFO 


8MB*CKUP' 


■ UOO 


8MBCDHEXI 


• 4876 


•HBSYF ■ 


1*00 


8MCL08F i 


■ i*E7 


SMDEVERRi 


M*3R 


SMOFIS i 


■ US* 


SMDFOS i 


■ U5* 


•MFEOD ■ 


1*43 


•MFJMOF i 


UB86 


8«GETF i 


UB2F 


8HGET0F i 


■ UOR 


8MGETQF i 


• 18*4 


•MHEXRCOi 


4B6* 


•MINIT i 


■ 1832 


8MJOBFIN1 


■ 1R92 


8H8TART i 


■ 4881 


8M8TOP i 


• 4884 


•MMHS6 ■ 


IBID 


SNXKEV i 


■ UID 


8MXTKD i 


■ U«* 


9M*P i 


■UOO 


START ■ 


• 1B3E 


ITATU8 ■ 


1ABS 


8TTKAB»*Hi 


■ 1BA3 


STIVER i 


■ 188C 


8TL8CMK i 


■ 1820 


8T0P i 


• 1B4E 


•TPIOi ■ 


1*31 


8TPI02 i 


■ 1A33 


8TRT101 i 


■ U36 


8TRTI02 i 


■U3B 


SYWCUP i 


■ UF7 


TD10A0 ■ 


18SE 


TELC^TRL' 


■ U03 


TElERRORi 


■ 1620 


TELEXEC i 


»U02 


TELREAD i 


•1*1* 


TEST ■ 


1AB9 


TE8TBUF i 


■flsae 


TESTLOOPi 


mot 


TE8TWTR i 


■ 4BC0 


TEXBUFFRi 


•use 


TEXEXEC ■ 


UOO 


TEX1T ( 


■ 4CF7 


TI i 


■ 1*02 


T1CR*SH i 


■ UFS 


TIME i 


■ 1B5F 


TI02ABENI 


1AE8 


TIOSDHUC 


■3C1F 


TIPFT i 


■ 3C08 


TISAST ' 


■ 1839 


TI8CHN i 


■3BF9 


. TIIO ■ 


3B3E 


TX8DECHNI 


■ 3BE4 


TISEARCMi 


■ 3R20 


TI8REA0 i 


■ 1B00 


T2S1S i 


■ UOO 


TII21 ■ 


1*37 


TNABORT i 


■ 4310 


TM*BPTT I 


■ «3U 


T*CK*DP i 


■ 40AE 


TMCKAOR i 


•407* 


TRDCBERR" 


1*46 


THDELAETi 


■ 18*7 


TMDEQ i 


•U*E 


T«ENO i 


■ U34 


TMFXNOJ 1 


■ HIT 


TMFI»(DT ■ 


lAilC 


T«ETID8< 


■uio 


TMGETJIDi 


•U1E 


TMGETTIO' 


»U50 


TMGRA i 


•4093 


, TRl* ■ 


43*8 


TM8ETE « 


■ UOB 


THSETP8DI 


■ 4F81 


T«SETREG' 


■ 4F7B 


TH8TOP i 


• 1871 


Tmitoplni 


1B*4 


T"TERm « 


■4313 


THTRMJ i 


■ «330 


THTRMT i 


14318 


THTYCB I 


•4054 


TRTYC8 ■ 


4055 


TMTYC15 i 


■4DSC 


TMTYC158I 


1*059 


TMy*OR i 


■ 4D72 


THWALL • 


• UOA 


TRAPCRSH* 


4C05 


TRAP5 i 


■4BD3 


TRAP70 I 


■ROOF 


TRTN i 


■ ttCFE 


TRTY i 


•4CF5 


TRUNCATE! 


U7B 


TTDEBuC i 


UBOa 


TTL* « 


UARC 


TTPRIM i 


■ U57 


TYPE • 


HASO 


UBEARCH ■ 


UOO 


VE»*CCNT« 


■ 1BU 


MAITALL < 


HA05 


HAITANY I 


■ U09 


WBLOCK i 


• 184* 


VeCETJOBi 


UB9 


WCOOP i 


■«B22 


WCST8YM a 


HACP 


HEOF • 


>UM 


WEOFOEV i 


'U2C 


MLBLOCK ■ 


1*09 


tfRITDlR i 


■ 1BB9 


IPALTENTi 


HB2F 


|«*SSGN I 


• UA9 


IfBRNCM I 


11882 


|«eALENT« 


1839 


l«C0*3G < 


■ U05 


l^niPRETi 


• 1*05 


l«DOO»P I 


mu 


IROOlNXTi 


'188A 


MOORET ■ 


IB** 


|RDOSN*Pi 


■ 1874 


tPOOTRAPi 


I1B90 


UOOVAL i 


■ 1852 


IRDUMP i 


• U07 


liEKCT ■ 


1B85 


IRJN8RT i 


■ U1F 


IPLOOK i 


■ 184F 


IPHOOFV i 


■ 1*05 


|«N*ME 1 


• USF 


liPATCH ■ 


1B38 


IROUIT i 


■ 1897 


|«RE«OV < 


■ UE* 


ItRERCMKi 


■ 1848 


t«SC*N I 


'1*04 


IPSCNOR ■ 


UB4 


IRSCNlCXi 


■ 1*04 


tRSCNLMXi 


»U0C 


l«SCNMDX< 


>U08 


l«SN*P I 


• 1*90 


t#|MAPITi 


\kff 


IRTINIT i 


■ 1*20 


|«TR*PEXi 


■ 18*1 


UTRAPlNi 


■ 1*58 


UHK80Z i 


• 1897 


F6L2B04 i 


10000 


FGL2B30 


■ 0000 


PGL38B1 i 


■ 0000 


NTTYPE i 


■ 0000 


OTEHP i 


■ 0000 


Tl"Pt ■ 


• 0000 


CON4ISCM 


■ 0000 


COWVSECTi 


■ 0000 


CONV1 i 


■ 0000 


CONVJ i 


•0000 


CRlCCU ■ 


H*5C 


CPLCOUT \ 


■5*5* 


CRDIN i 


■5530 


CROIMCU i 


15532 


CRDOCU i 


•5SC2 


CRDOUT I 


IS5C0 


CRFILR « 


■ 0000 


OUMMVMQ I 


■ 0000 


EMOAISCHi 


■ 0000 


FCRCRAUTi 


• 0000 


FCP.CPBINI 


ioooo 


PCRKPrfE 


■ 0000 


rc«KP^»jLi 


■ 0000 


FCRKPWOEi 


■ 0000 


FCWCPBCOi 


• 0000 


rcucPBiNi 


10000 


FCMKP I 


■ 0000 


PCWKPWtKLl 


■ 0000 


FCNNU < 


■ 0000 


KBTCU I 


•5042 


KBTIO ■ 


15030 


HDL7261 i 


■ 0000 


MDL7266 I 


■ 0000 


MDLT275 i 


■ 0000 


POSITAX I 


• 0000 


twoEvr i 


10000 


TELBUFFR 


■ 0000 


BFT*OD i 


■ 0000 


RFTBAOD i 


• 0000 


RFTFADD i 


•otfoo 


6CT4A i 
TXITK2 ■ 


iOOOO 


GIOEX 


■ 1*89 


8C*MEX i 


■ 1*88 


EXXTCRS t 


•1BB1 


EXXTE8U i 


■ins 


'1B9C 


EXITK3 ' 


■ 1B9F 


EXITKR I 


■ 1BA2 


EXITKS i 


■ 1B*5 


EXIT** i 


ii"B*e 


KXITK7 i 


'18*8 


KEY1EX6 


■ 1BEO 


KEY2A04 I 


■ UOa 


KEY2EXB ■ 


•18C4 


CRSHEX ■ 


• 1897 



Figur»29. SYSGEN MopEwwnpI. (cont.) 
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KEY3*0a 


■U1A 


KEV3EXB 


■ 1B9F 


KEVitAoa 


• 1*1* 


KEYflEXR ■ 


1*2C 


KEYSAOtt i 


>1A19 


KEY5EXB 


»1A25 


KEY6A0* 


• 1A1B 


KEV6EXB 


■1A20 


KEY7*oa ■ 


1A19 


"EY7EXB i 


"1*28 


FGL1EXIT 


»1A|7 


•6L2EX 


• 1*1* 


PGLHCX 


■ 1*61 


F6L3X ■ 


1A3D 


SCMEOX i 


•1418 


8CMSCX 


•MET 


8CSUB8V 


■ UC3 


RKLA8SNX 


Bi*90 


BKLEXIT ■ 


1*15 


ABEXEXITi 


>1A3« 


ABEXRBX 


HABF 


DEXJT 


■ 1B8A 


PFGDX 


BlBDB 


OISCCU ■ 


51*5 


DISCIO i 


• 5l«0 


DPAK 


■S1ET 


DPAKCU 


■5239 


IPP08T 


■ 5«5D 


LPPRE » 


5010 


MT*P , 


I56B0 


MT4PCU 


■ 56B8 


PRTCU 


■S«31 


PPTLCCU 


■ 5*>31 


PRTLCOUTB 


5012 


PRTOUT i 


■5aio 


TAPEPOST 


• 5680 


TAPEPRE 


■56B0 


346XP0ST 


■ 5«7B 


3«6XPRE ■ 


5«1« 


7TAP i 


•56E3 


7TPPCU 


■ 56B8 


CABDPOST 


B5S67 


CARDPRE 


■ 5565 


CON^EXITB 


1B4IB 


OISCTOFTi 


10000 


E*QX1 


■ 1A00 


EWQX2 


■ 1A01 


fHQXU 


■ 1A02 


ENQXR * 


1A05 


DELEXIT i 


■ 1*31 


DELTRapx 


■ 1A32 


PMDELX! 


B1A6D 


P-BFXJ 


■ 1A00 


RmBFXIO ■ 


1*08 


R»«BFX11 1 


• 1AAA 


RNBFX2 


■1*01 


RriPFXS 


B1A02 


RwBFxa 


■ 1A03 


RN9FX5 ■ 


1*00 


RHRFX6 I 


• 1*05 


R*BFX7 


■ 1*06 


RwBFXB 


BIA07 


FBPXITEB 


■ 1*03 


FBBX1 m 


1A00 


FBBX2 i 


■ 1*01 


FBBX3 


■ 1A93 


DEVEHR 


■ 1825 


"FVEXIT 


■ 1*21 


DEVEX? ■ 


1B27 


A8SIGNX i 


I1AA9 


OPENl* 


■ 1*90 


OPfNlB 


Bl*91 


PPEN2A 


■ i*9« 


0PEN2B ■ 


1A95 


CFUHOX i 


■ 1«BF 


CLOSEli 


■ 1*33 


CL0SE1B 


B|A3A 


CL0SE1C 


■ 1A3C 


REWERti ■ 


1A07 


REhfcXIT i 


■ 1A0<1 


PEHEXOI 


■ iADO 


*E"X1 


H106 


PEUX2 


■ 1*1« 


RE«X3 ■ 


1*26 


REwxa i 


■ 1AEE 


SfcTuPXl 


■1BE2 


ME0FX10 


• 1A18 


PEmOXI 


■ uoo 


RE-DX2 ■ 


1*28 


REWDX3 i 


■ 1A26 


PENDXtt 


■ 1*28 


REfOXS 


B1A20 


GCFXIT 


■ 1AAC 


TVPREXITB 


1A4F 


TYPREX1 i 


■ M«E 


IOXEXIT 


■1B1B 


IOXTRAPX 


■ 1B1A 


POLLABX 


■1B0E 


SIGX ■ 


1*00 


SIGX1 i 


■1A01 


8IGX2 


■ 1*02 


SIGx* 


B1A03 


BIGX5 


■ 1A0« 


S1GXB ■ 


1A07 


8IGX9 i 


• 1A08 


JCALERP 


•1BCT 


JCALEXIT 


■ 1BC6 


KEDCEXIT 


■ 1*66 


SMAHEXITB 


1A59 


BNAMEXOli 


■ 1A3B 


8NAMEX02 


»1*3C 


8CALERR 


B1A32 


8CALEXIT 


■ 1*31 


SCALTRPXB 


1*33 


STLBCKKXi 


»1B«1 


RUNX 


■ 1*96 


SCERRX 


B1AC9 


BC^ORHX 


»1*C6 


SCTRAPX ■ 


l*CB 


PINTX i 


UAOO 


PINTX4BN 


■ U0« 


PIMTXRB 


■ 1*05 


PINTXSIG 


■ 1*03 


PINTX1 • 


1*01 


PINTX5 • 


»1A02 


8M6ETFX 


■ 1B9D 


8Y*2X1 


■ 1*01 


8VM2X6 


■ 1*03 


8YM3X3 ■ 


1*01 


8YM3xa i 


UA03 


8YMJX5 


«1*0« 


8VH3K6 


• 1*06 


8YM5X1 


"1*01 


8Y«5X2 « 


1*03 


8EGEXIT i 


usaj 


TRMX 


• 1A07 


TRMXBfl 


BlAOO 


TRKXTERM 


■ 1*01 


TRNXTRMJ* 


1*02 


TMXAB i 


HAOS 


TMXABT 


■IAOI 


TMXBAn 


BjAOO 


T»1XC*LX 


■ 1A0? 


PAITXR8 ■ 


1*0* 


TTLNX i 


HAS5 


TTX 


■ 1A0S 


PHJCExIT 


BlADfl 


JMTENQZ 


■ 1AF2 


JMTRmx ■ 


1*79 


TTJOBX i 


■ 1*21 


TTJX 


■ 1*05 


2ETMXB 


BiAOl 


ALLEXJT 


■ 1ABD 


ALLTRAPXB 


1*00 


J0BERR3 i 


HBas 


JOBEX 


• 1B73 


JOBNX 


■ 1*70 


JOBSCX 


■ 1BA4 


J06SCXE ■ 


1BA5 


JTRAPX i 


118(15 


JOHDX 


■ 1A50 


J0BH3GX 


■ 1AC0 


J0R2X1 


■1*01 


J082X2 ■ 


1A03 


8ETPX i 


■ 1*90 


ESUMXJT 


■ i*6E 


JHEXIT2 


■ 1BB9 


SAIEXIT 


■ 1B59 


CRSXIT ■ 


IBOR 


REX1 i 


•1BB1 


REX2 


>IBB3 


CR82XIT 


■ 1*06 


CRS2XIT2 


■1*21 


CKDXIT ■ 


1*51 


CKD2XIT • 


■ 1*89 


CRDXIT 


•1*F2 


TI01EX01 


■ 1822 


TIS*BEMX 


■ 1B38 


TI02EXITB 


IBS* 


TI02EX02) 


■ 1AC8 


TI02EX03 


■1AD1 


TI02EXOO 


B1A03 


TISEXIT 


■ 1AF« 


PLOIFXITb 


1*0* 


ERRXIT i 


UBDC 


LOCXIT 


■ 1*68 


MHCALX 


B1BC2 


HH01EXIT 


■ 1BE6 


HM02EXITB 


IBF8 


MH03EXITI 


■ 1BE0 


MM0«EXIT 


■ 1BF9 


HMOSEXIT 


■ 1BF6 


MM06EXIT 


■ lBttC 


IPLMMfX B 


1819 


ISYMEXITi 


■ 1*B* 


OBUCCALX 


• 1BBC 


DBUGINTX 


■ 1B*2 


0BE»R1 


■ 1*01 


DOVALEXTB 


1*98 


GOOUMPITi 


■ 1A0* 


8NAPEXIT 


• 1626 


USRJ^i 


■ 1A03 


. 0*ERR2 


■ 1*01 


TRAPRTN b 


1**1 


U8RIN2 I 


■ 1A0S 


DBERR3 


•1A01 


DUHPEXIT 


■ 1A9F 


3CNDR0UT 


■ 1B26 


USRIN3 ■ 


1*0) 


DBERR* i 


■ 1*01 


8CAN0UT 


■»*C2 


TTDBUGX 


■ 1BED 


USRlN* 


■ 1A03 


•EARCHEXB 


1A4F 


BNAPOUTH 


MB76 


8NAPOUT2 


■ 1B76 


TRAPINEX 


BlBAO 


TRAPOUT 


■ 18*6 


BRAEXIT ■ 


1BD8 


DBERR6 ■ 


■ 1*01 


8CNEXIT 


•Ul« 


U8RIN6 


■ 1A03 


NE01EXIT 


■ 1*0D 


ME01XITAB 


1885 


HE02EXITI 


■ 1*53 


MEB2XITA 


■1ASU 


MED2XITB 


■ use 


ANLT9EXT 


■ 1*DB 


OFPMSGEXB 


1855 


TEXBBRTKi 


• 1*82 . 


VERACCEX 


• IB3<» 


ANLERREX 


■ 1BED 


OVERBGEX 


■ 1B65 


CNTRLEXTB 


i*2D 


TELlEXlTi 


■ 1*00 


CNTLEXIT 


■ lAltt 


TEL2EXIT 


■uoo 


TEL3RD 


■ 1B20 










RBH 


• 1DO0 


RB^END 


■SBDF 


PP8IM 


■ 0000 


DEC8IM b 


0000 


BYTSIM BO 


CVSIM 


■0000 


OELTA 


■0000 














•**• DISC ALLOCATION ••• 
















AREA • DEVICE 


HODEL FIRST 


LAST 


IIZE 


MP ***$ 








SP 


DPAEO 


7270 


1 


2100 


2100 


8 256 








FP 1 


DPAEO 


7270 


639} 


8190 


1800 


8 256 








BP 2 


DPAEO 


7270 


Bl«l 


9990 


1800 


8 /5* 








BT 3 


DPAEO 


7270 


3921 


6320 


moo 


8 256 








CK S 


DPAEO 


7270 


2101 


2520 


«20 


8 256 








Dl • 


DPAEO 


7270 


2521 


3920 


1*00 


8 256 








18 7 


DPAEO 


7270 


6321 


•3«0 


20 


8 256 








08 8 


DPAEO 


7270 


6341 


• 390 


50 


8 256 








05 9 


DPAEO 


7270 


9991 


•17999 38009 


B 25* 








•**• END 


HAP ***» 
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The CP-R overlays (which may optionally bo made resident) 
consist of the subtasks of the CP-R Control Task and «ho var- 
ious user services, which include: 

Key-in Processor 

Background Abort/exit Routine 

Postmortem Dump 

Foreground Root Loader 

Background Root Loader 

foreground user services 

Background user services 

MEMORY LAYOUT AFTER SYSLOAD 

After SYSGEN and SYSLOAD have executed, memory would 
have the following typical layout: 



MX ALLOCATION 



Write 

Lock 

11 



Write 
LocH 
01 



Write 

Lock 

00 



Write 
Lock t > 
10 



Interrupts, traps, etc. 



Unused interrupt locations used for 
monitor tables 



System flags and pointers 



CP-R tables and dynamic space 



Patch area 



CP-R overlay area (1 page) 



Resident nonoptional routines 



Resident optional routines 



Monitor expansion area 



Foreground 
Private 



Foreground Mailbox(es) 
Foreground Blocking Buffers 



Foreground 
Preferred 



Secondary 

Task 
Memory 



320 



page 
boundaries 






DISK AREAS 



During SYSGEN, the permanently mounted disk space is 
divided into areas. There is a maximum of 23 standard area. 
The names of these areas, their common usage, and other 
information is given below. Additional user defined areas 
are identified by any unique two-character name and are 
assigned space at the same time as the standard areas. The 
only restriction placed upon names of user defined areas is 
that they may not match operational label names. The size 
and location of the areas are fixed by SYSGEN and can be 
changed only by another SYSGEN. 

With the exception of those files that contain the generated 
system, the definition of files on disk storage is not a func- 
tion of SYSGEN. 

The standard SYSGEN areas, their names and their normal 
order of allocation is as follows: 



Area Name 


Area Mnemonic 


Write Access 


System Program 


SP 


SYSTEM 


Foreground Program 


FP 


SYSTEM 


Background Program 


BP 


SYSTEM 


Foreground and 
Background Data 


D1 through DF 


Foreground or Back- 
ground as specified 


Input Symbiont 


IS 


Background 


Output Symbiont 


OS 


Background 


lOEX Access 


XA 


IOEX 


Checkpoint 


CK 


SYSTEM | 


Background Temp 


BT 


Background 


User Defined 


XX 


As specified 



512K (real) 



The user can specify a given area to physically reside on 
any disk in the system if the system contains more than one 
disk; however, each area must be wholly contained on one 
disk. The user must also specify a disk to be the system 
disk, which will contain the SParea and receive the CP-R 
disk bootstrap. 

The System Program area of the disk contains the monitor, 
service processors (Overlay Loader, RADEDIT)^system pro- 
cessors (AP, FORTRAN, etc.X and the System Library. 

The Foreground Program area of the disk should contain the 
user's foreground programs, the Public Library, and the User 
Library, if they exist. 

The Background Program area should contain any permanent 
user background programs. 
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The IOEX Access area con be written only by IOEX and 
should normally be the only area of tho disk that IOEX is 
allowed to access. 

The foreground and background Data areas can be used to 
store the appropriate type of user data. Up to 15 Data areas 
(D1-DF) are allowed, to accommodate a user with multiple 
disks. If the Accounting Log file, AL is used, it must be 
allocated on the 01 area with a background-write protect 
code. 

The Input Symbiont area contains background fobs waiting 
to run (or running) while the Output Symbiont area contains 
output from those jobs. 

The Checkpoint area is used to save the contents of rolled- 
out segments. The Background Temp area can be allocated 
to a maximum of nine scratch files (XI -X9) plus the GO and 
OV files. 

If a user does not choose to specify the sizes for the differ- 
ent disk areas, SYSGEN will attempt to allocate, on the 
system disk, the default sizes given in Table 30. If there 
is not enough system disk space to allocate default sizes, a 
disk OVERFLOW message will be output. 

Table 30. Disk Area Default Sizes 



Area 



System 
Program 



Foreground 
Program 



Background 
Program 

Foreground/ 

Background 

Data 

Input 
Symbiont 

Output 
Symbiont 

IOEX Access 

Checkpoint 

Background 
Temp 



Default Size Comments 



1500 
sectors 



Large enough to contain 
all system processors, one 
per file, in load-module 
form; the system library 
format; and the monitor 
'.. absolute format. 

User is required to specify 
number of tracks for all 
areas not used by system 
programs. 





n sectors 

m sectors 



A nominal area size is 
approximately 250 sectors 
(256 words per sector). 

A nominal area size is ap- 
proximately 1000 sectors 
(256 words per sector). 



Where n=the size of real 
memory in sectors. 

Where m* remainder of 
disk. Disk size is deter- 
mined from the ENTRACK 
parameter on the :DEV1CE 
command. 



The areas will be physically located on disk in the same 
order as they were input during SYSGEN. The System Pro- 
gram area will be the first orea on the system disk unless 
the user inputs the SP area in a different order. All disk 
areas required by the user must be specified except those 
areas that SYSGEN automatically allocates by default. 

Beginning at the starting sector input on the -.DEVICE com- 
mand, SYSGEN will allocate the number of sectors for each 
area without leaving empty spaces between areas. A bad 
areo on a user's disk can be skipped via an input to the 
RADEDIT at the time the user's files are defined. The sys- 
tem disk will include the CP-R Bootstrap and therefore the 
actual space available will be one sector less. 



BACKGROUND TEMP AREA 

The scratch files (X! through X9) of the Background Temp 
area of the disk will be automatically allocated and defined 
by the Job Control Processor prior to execution of a back- 
ground program, unless the user wishes to override these de- 
faults via an IALLOBT control command. During SYSGEN, 
the user will not specify any standard sizes for the scratch 
files, X1-X9. The X1-X9 files are reallocated before exe- 
cution of each background job step. 

The GO and OV files are also in the BT area of the disk. 
These files are more permanent than theXl-X9 files and are 
maintained throughout an entire job. The user has the op- 
tion to override the default permanent size of GO and OV 
at SYSGEN time via the rALLOBT command. The perma- 
nent size, determined at SYSGEN, of either file, can be 
altered through the background job stack via an IALLOBT 
control command. 

An example of allocation of a system disk is given in Figure 30. 



Bootstrap 


SPArea 


FPArea 


BPArea 


Dl Area 


D2 Area 


XAArea 


CK Area 


BT Area 



(°~ ) 1 1501 sectors 
Wor/ [(default 
J size) 



Size must be 
• specified by user or 
area is not allocated 



Size at real-memory 
(default size) 
Remainder of disk 
(default size) 



Figure 30. Disk Allocation Example 
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Table 31 gives the default sizes and types for GO, OV, and 
X1-X9, and the order In which the files ar* allocated. Note 
that X1-X9 arc at tfia front of fho BT area, end GO and OV 
or* at tha opposite ond. 



TABLE! ALLOCATED AMD SET BY SYS6ER 

DEVICE CONTROL TABLE (DCT) 

The DCT table is allocated by SYSGEN and several of the 
entires in the table are set by SYSGEN (i.e., device type, 
device number, dedicated to foreground bit, etc.). The 
DCT contains one entry for each device input by the user 
on the : DEVICE command, and the order of the entries is 
the same as the order of the .-DEVICE commands. Note that 
there will be only one entry in the DCT for each disk. 



RAD FILE TABLE (RFT) 

The RAD file table U allocated by SYSGEN from the FRAD 
and BRAD entries on the -.RESERVE command, and should 
contain sufficient entries to reflect the maximum number of 
open disk files that can exist simultaneously. The user will 
input the number of RFT entries to be reserved for foreground 
pro g r ams and the number to be" reserved for background pro- 
grams. The background is not allowed to use more than the 
number of RFT entries allocated for the background. How- 
ever, the foreground can use all RFT entries if they are 
needed. The rationale for having foreground/background 
disk files as opposed to a single pool of files is that o back- 
ground program could erroneously use all the file entries, 
thus preventing the operation of a foreground program. 



MASTER DIRECTORY 

The Master Directory is entirely set up by SYSGEN in the 
resident monitor portion of memory and contains the fol- 
lowing information about each area on disk: the sector 
address of each area, the disk to which the area is assigned, 
the sector size and number of sectors per track; a bit that 
states if an area has been allocated; and the write protec- 
tion code for the area . 

OVERLAY INVENTORY (OVI) 

The Overlay Inventory table is entirely set up by SYSLOAD 
and contains the information the monitor needs to load a 
CP-R overlay. This information consists of an overlay iden- 
tifier, the seek address of the overlay, the real memory ad- 
dress, the w count, and the number of bytes in the overlay . 
The overlays are put on a page boundary during the genera- 
tion of the system. 

I/O QUEUE TABLE (IOQ) 

The IOQ table is allocated by SYSGEN from the FIOQ and 
BIOQ entries on the :RESERVE command . The user inputs 
the maximum number of I/O operations that can be queued 
at one time for the foreground and background. The restric- 
tions on the use of the foreground IOQ table are the same 
as for the RAD File Table. 



LOAD MODULE INVENTORY (LMI) 

The Load Module Inventory contains an active entry for 
each foreground program loaded into memory . Requests to 
load a foreground program con be made from either another 
foreground program or by the operator. Space for this table 
Is allocated by SYSGEN from the FRGD entry on the 
:RESERVE command. 



Table 31. GO, OV, X1-X9 Default Sizes 



File Name 


File Type 


Default Size 


Comments 


XI 1 

X2 

X3 

X4 

X5 

X6 

X7 

X8 

X9. 


» 


Unblocked 


Determined by Job 
Control Processor at 
execution time. 


File type and record sizes can be changed through 
a Device Mode function call or through an IALLOBT 
commond* 


OV 


Unblocked 


128 sectors 


... . ^ 
Default output for Overlay Loader. Used mainly 
to test a program that has no permanent file de- 
fined, or to test a new version of a program with- 
out destroying the current version. 


GO 


Blocked (120 bytes/ 
logical record) 


128 sectors 


Used by FORTRAN and AP for "assemble and 
go" type operations. 
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SYSTEM JOB INVENTORY (5 J!) 



INTERRUPT LABEL TABLE (INTLB) 



The System Job Inventory contains an active entry for each 
job in the system. Requests to start a new job or to stop an 
existing one can be made either by a foreground program or 
by the operator. Space for this table is allocated by 
SYSGEN from the JOBS entry on the RESERVE command. 



The INTLB table is set up by SYSGEN from information 
contained on the :INTLB command. The table contains the 
name of each interrupt and the location to which the inter- 
rupt is assigned. 



SYSTEM TAS.K INVENTORY (STI) 

The System Task Inventory contains an active entry for each 
task in the system. Requests to connect a new task or to 
stop an existing one can be made either by a foreground 
program or by the operator. Space tor this table is allo- 
cated by SYSGEN from the TASKS entry on the :RESERVE 
command . 



OPERATIONAL LABEL TABLE (OPLBS) 

The OPLBS table is built by SYSGEN from the information 
input on the :STDLB command. The table has a minimum 
of eleven entries that contain the standard system opera- 
tional labels. Since operational labels are referenced via 
an index value in the DCB, each of the eleven standard op- 
erational labels have a fixed index value. If the user adds 
his own operational labels to the table/ the user operational 
labels are assigned an index value/ starting with 12, in the 
order in which they are input on the :STDLB command. The 
standard operational labels and index values are 



Op Label 


Index Value 


C 


1 1 


oc 


2 


LO 


3 


LL 


4 


DO 


5 


CO 


6 


BO 


7 


CI 


8 


SI 


9 


BI 


10 


SO 


" J 


XX 


12 1 


YY 


13 



Standard operational 
labels 



SE 


User + 1 


ER 


User + 2 


DI 


User + 3 


DL 


User + 4 


DP 


User + 5 


PI 


Lher+6 


P2 


User+7 



User-defined operational 
labels; (index value de- 
pendent upon order on 
:STDLB command). 

Generated after user op- 
erational labels if ALARM 
and ERRORLOG are 
specified. 



Generated if DEBUG h 
specified. 



IBPOT PARAMETERS 

After SYS GEN and SYSLOADore looded by SYSGENLOAD, 
Control is transferred to SYSGEN. SYSGEN types out the 
message 



CP-R SYSGEN 


If Sense Switch 3 is set, 


SYSGEN 


will 


type 


the message 


IN, OUT DEVICES 



and request input from TYA01. The operator must then type 
in a valid SYSGEN command. 

SYSGEN aN,yyneld^nmmm)[,(OUT,yyndd,mmmm)] 



where 



IN specifies the device in the format yyndd from 

which the remainder of the SYSGEN control com- 
mands will be input. 

yy Is a device type code and must be either 

CR, or TY (see below for a description of 
the codes). 

n is the IOP; legal values are A-H correspond- 
ing to lOP's 0-7. 

dd is the hardware device number of the device. 

mmmm is the hardware model number. 

OUT specifies an optional output device on which 
the input commands are to be logged or the map, 
if requested, is to be output. The device type code 
must be either the TY or LP. 



If Sense Switch 3 is reset, default IN, OUT devices will be 
used. The default command b 



SYSGEN (IN,CRA03,7120),(OUT,LPA02,7440) 



Following input of the SYSGEN command, the SYSGEN 
control commands are input through the specified device. 
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The following device types ore st cn d md under CP-R and 
should bo input in the yy portion of o yyndd parameter in 
all SYSGEN control u ww m on di : 



Device Type 


Code 


Device 


NO 


Not a standard device. A 
special purpose device for use 
with IOEX. 


TY 


*• 


Typewriter 


LP 




Line printer 


CR 




Card reader 


CP 




Cora punch 


9T 




9-traclc magnetic tape 


7T 




7-track magnetic tape 


DC 




RAD 


DP 




Disk pack 


PL 




Plotter 


LD 




Logical Device 



SYS6EN CONTROL COMMANDS 

The SYSGEN control c ommands are given below. SYSGEN 
control cards follow the same syntax rules that apply to other 
control commands. The general control card syntax is de- 
scribed at the beginning of Chapter 2. The rMONITOR and 
:RESERVE commands (in that order) must be input prior to the 
:DEVICE command. A ;DEVICE command must precede a 
tSTDLB command that references that device. 



iPROC This command defines the processors In a 

Xerox 550 system. It is not used on Sigma systems. The 
information from this command is used to place a record of 
the system configuration in the Error log file. It also drives 
the processor polling activity subsequent to certain fault 
situations. 

The :PROC command has the form: 
/:PROCE5SOR (option), (option) . . . , (option) 

The options are: 



MIOP, value 
HSR, value 



PI, value SU, value 
MI, value CPU, value 



Example: 

tPROCESSOR (HSR, B) 

defines cluster 1 unit 3 as a high speed RAD IOP. 

Note: The MIOP containing th« console teletype must be 
unit in cluster 0. 



{MONITOR The :MONITOR command specifies monitor 

and CPU options. The :MONITOR command must precede 
the :RESERVE command and must precede the :DE VICE com- 
mand for the system disk. 



The command has the form 



MONITOR (option) [, (option). . ., (option)] 



where the options are 

CORE, size specifies the real memory size, in deci- 
mal units of K (where IK = 1024 words), of the 
target computer (computer for which the SYSGEN 
is being run). The default value for CORE is 32K 
words. 

FPSIM T specifies that the floating-point simulation 
package is to be loaded by SYSLOAD. K this pa- 
rameter is absent, either the floating-point hard- 
ware exists or floating-point is not needed for the 
target computer. 

DECSIM T specifies that the decimal instruction 
simulation package is to be loaded by SYSLOAD. 
The absence of this parameter indicates that either 
the decimal instruction hardware exists or the dec- 
imal package is not needed for the target computer. 

BYTSIM r specifies the byte string instruction simu- 
lation package is to be loaded by SYSLOAD. 

CVSIM* specifies the convert instruction simulation 
package is to be loaded by SYSLOAD. 

ALLSIM T specifies thatall software instruction sim- 
ulation packages are to be loaded by SYSLOAD. 

REBOOT specifies that the default action taken 
following a system alarm will be a Re-Boot and 
initialization. 

ALARM specifies that all code associated with han- 
dling system alarms wil I be included in the gener- 
ated system. 



The values are the hexadecimal processor addresses, 
keyword is the processor type. 



The 



Standa rd CP-R allows the use of instruction simulators when 
the hardware will not handle a given instruction. If an in- 
struction simulator is not loaded during SYSGEN and that 
type of instruction is executed, CP-R will simulate a TRAP 
to location 40. 
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ERRORLOG specifies that alt cod* associated with 
handling error legging will be included in the 
generated system. 

DEBUG specifies that all code associated with 
DEBUG will be included. 

LPP,value is number of lines per printer page. The 
default is 37. This value is used by processors 
that perform their own vertical format control of 
the- printer. 

V 

ACCT specifies that the monitor is to perform job 
accounting. Absence of the ACCT parameter indi- 
cates that no job accounting is to be kept. 

OLA YEP, value Is the number of entry point and 
exit point locations in the system. The value de- 
faults to an assembly parameter (see PROGRAM 
ALLOCATION section of map for a list of entry 
and exit points). 

ROLAY,name specifies that the named overlay 
module^ is to be included and be mode resident. 

NROLAY,name specifies that the named overlay 
module' is to be included (as nonresident). 

BOUND specifies that resident overlays are to start 
on even X'10' locations. 

SPAI, xx specifies that disk area "xx" is the system 
processor alternate area, which acts as an exten- 
sion to area SP for the location of programs called 
by the JCP processor name commands or TEL RUN 
commands. 

'.RESERVE The :RESERVE command allocates areas of 
memory and the various variable-length monitor tables. The 
:RESERVE command must precede the :DEV1CE command for 
the system disk. 

The :RESERVE command has the form 



(' 



RESERVE (option) [.(option). ..,(option)] 



where the options are 

TSPACE,size specifies the number of words to be 
allocated for the CP-R dynamic-space pool. The 
default number is formulated as follows: 



each JOQ entry 
each TAS K entry 
each JOB entry 
each JPT entry 



8 words 
192 words 
32 words 
4 words/job 



The SYSLOAD map value S:TEMPN may be exam- 
ined to determine the resultant value. 



The named module and its size (nonresident) or base address 
(resident) may be found in the SYSGEN map under "CP-R 
PROGRAM ALLOCATION" as the first entries. The user may 
choose size or performance trade-offs by use of these options. 



RSDF,siza[,stort] specifies the size and starting ad- 
dress of a foreground-private memory partition, to 
be reserved for the exclusive use of primary tasks. 
(Several such partitions may be declared by mul- 
tiple uses of this option.) "Size" is the decimal 
number of contiguous real pages to be reserved; 
"start" is the hexadecimal starting address of the 
partition, which must be on a page boundary in the 
first 128K of memory and may not foil within any 
other defined partition. The default for "start" is 
the first page boundary above the resident monitor. 
If the option does not appear, no foreground- 
private partition is allocated. 

This space is available for oil primary foreground 
programs on a first-come, first-served basis. A 
program is given its predetermined memory space 
(determined when it is linked by the Overlay 
Loader) when loaded for execution. No other pro- 
gram can use this space until the program is 
unloaded. 

MPATCH^ize specifies the decimal number of 

word locations to be reserved for modification 
to and expansion of the monitor. The default size 
is zero. 

FFPOOL,*5ze[,start] specifies the number of fore- 
ground blocking buffers to be reserved, for use by 
primary tasks only, either as a separate foreground- 
private partition or as an area within the first 
partition defined via RSDF. "Size" is the dec- 
imal number of 256-word buffers to be allocated; 
"start" is the hexadecimal starting address of the 
blocking-buffer partition, which must be on a 
page boundary in the first 128K of memory and 
may not foil within any other defined partition. If 
"start" is omitted, the blocking buffers will form 
an area at the end of the first-defined foreground- 
private partition such that the starting address will 
default to the upper bound of RSDFq less the size 
(in words) of the allocated buffer pool. If the 
FFPOOL option does not appear, no blocking 
buffers ore allocated; one buffer, however, is 
required to initiate a foreground primary load 
module. 

LDMD,value specifies the maximum number of 

foreground load modules that can reside in mem- 
ory at any one time. This parameter will be used 
to allocate space for the load module inventory 
that is used to manage the foreground private area. 
The default size is zero. Maximum allowable 
value is 250. 

H * 

TASKS, value specifies the number of entries to re- 

serve in the System Task Inventory. This number 

must be adequate to meet the peak requirements 

of all foreground tasks. The default size is zero. 

The maximum allowable value is 250. 



tt SYSGEN will odd entries for the CP-R job and the back- 
ground job. 
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JOBS,vol«M t specifies the number of entries le be 
reserved tn the System Job Inventory. One antry 
exists far each octiva fob. TKa default t ize k 
zero. The maximum allowable value b 30. 

JPT,value specifies the number of entries to be re- 
served in Job Program Table for each fob (see the 
SETNAME service cell). The defoult size is zero. 
The maximum allowable value is 63. 

FRAD,value specifies the number of entries to re- 
serve in the RAD File Table for foreground disk 
files. This number should reflect the maximum 
number of foreground disk files that could be open 
simultaneously. Note that the background disk 
pool is also available to the foreground. The de- 
fault value is zero. 

BRAD, value specifies the number of entries to re- 
serve in the RAD File Table for background disk 
files. Thir number should reflect the maximum 
number of background disk files that can be opened 
simultaneously. The default value is 5, which is 
sufficient to accommodate the requirements of the 
system processors. The value indicated should not 
include the files in the BT area of the disk. 

FIOQ, value specifies the maximum number of fore- 
ground I/O operations that can be queued at any 
one time. This parameter determines the space 
allocated for foreground entries in the I/O queue 
table. Note that the background queue table is 
also available to the foreground. The default 
value is tero. Note that this must include queue 
entries for COC input and output requests. 

BIOO, value specifies the maximum number of back- 
ground I/O operations that can be queued at any 
one time. This p arameter determines the space 
allocated for background entries in the I/O queue 
table. The default value allows three entries to be 
placed in the queue table. 

Note that the sum of FIOQ and BIOQ must be less 
than 256, or an error indication will be given. 

FMBOX,size[, start] specifies a foreground mailbox 
area to be reserved, for use by primary tasks only, 
either as a separate foreground-private partition 
or as an area within the first partition defined via 
RSDF. "Size" is the decimal number of words to 
be allocated for the mailbox; "start" is the hexa- 
decimal starting address of the mailbox partition, 
subject to the same rules as given for RSDF and 
FFPOOL. If "start" is omitted, the mailbox will 
form an area at the end of the ffrst-defined 
foreground-private partition but preceding the 
default blocking-buffer area, if any, such that 
the starting address will defoult to the upper bound 
of RSDFq less the size of the buffer-pool area, if 
any, and the size of the mailbox area. If the 
FMBOX option does not appear, no foreground 
mailbox is reserved. 



JENQ, value when added to the number of fob ex- 
clusive devices, specifies the maximum number of 
ENQs allowed within a job for a system level con- 
trolled item. This parameter determines the size of 
the AET which is linked to a job. 

TENQ,value specifies the maximum number of ENQs 
allowed within a load module tor a job-level- 
controlled item. This parameter determines the size 
of the AET which is linked to a load module. 

BT, value specifies the maximum number of Background 
Temp files (XI -X9) that will aver be used. The 
defoult value is 6, that is, files XI, X2, X3, X4, 
X5, X6. Six files are sufficient for the System 
Processors. The files defined are Xl-Xn, where n 
is the input value. The value must be leu than 10. 

PME M, size, start specifies the size and starting ad- 
dress of a foreground-preferred memory partition, 
to be reserved for the use of primary or secondary 
tasks. (Several such partitions may be reserved 
by multiple uses of this option. ) "Size" is the 
decimal number of contiguous real pages to be 
reserved; "start" is the hexadecimal starting ad- 
dress of the partition which must be on a page 
boundary in the first 128K of memory and may not 
fall within any other defined partition. If no 
PMEM options appear, no foreground-preferred 
partitions are allocated. 

BMEM, size specifies the maximum number of pages 
of secondary-task memory that may be allocated 
to the background. This value defaults to 32 if 
BMEM does not appear. It may be altered by 
the BMEM operator key-in. 



CHAN This command groups peripheral devices (see 

DEVICE below) according to channel controller. All 
DEVICE commands following a given :CHAN command are 
assumed to be part of that channel. At least one :CHAN 
command must be used, and each :CHAN command must 
precede the :DEVICE command (or commands) to which it 
applies. 



'SYSGEN will odd entries for the CP-R job and the back- 
ground job. 



The :CHAN command has the form 
/:CHAN [(DUAUnjd^n^O)] 



where DUAL,n|d]0,n2d20 specifies that this channel has 
dual-access capabilities, and that any following device 
command that has n3d3 (as in yyn3d3d), which matches 
njdj or n2d2, will be considered a dual -occ ess device. 
(Note that since all dual-access devices ore also multiunit 
controller devices, 03 and d3 are, in effect, IOP and chan- 
nel respectively. ) This dual feature allows the device to 
be referenced as either vynjdidor yyn^^' * nu * improv- 
ing throughput and reliability. 
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The :CHAN commend hot the form 



.-CHAN [(DUAUn jd^^jdjO)] 



where DUAL,nfd]0,n2d20 specifies thot this channel has 
dual-access capabilities, and that an/ following device 
command that has «3d3 (as in yyn3d3d), which matches 
njd| or n2d2, will be considered a dual-access device. 
(Note thdt since all dual-access devices are also multiunit 
controller devices, n3 and d3 are, in effect, IOP and chan- 
nel respectively.) This dual feature allows the device to 
be referenced as either yyrtjdjdor yynpd^/ thus improv- 
ing throughput and reliability. 

:0EVICE The :DEVICE command introduces peripheral 

units into the system. One .-DEVICE command is required 
for each peripheral unit to be used. The order of the 
rDEVICE commands determines the Device Control Table 
index value that the device will receive. If an error is 
mode in any field of the command, the entire command must 
be input again. 

The rDEVICE command has the form 

/••DEVICE yyndd,mmmm[,S] [, (option)] [, (option)]. . . 



where 

yyndd specifies the device name (see the :SYSGEN 
command for a description of yyndd). The device 
name must be the first field after :DEVICE. 

mmmm is the model number. Table 32 shows the 
model numbers for all supported devices. Table 33 
shows the model numbers and structural parameters 
for all disk devices. Model numbers of NO or 
NONE are allowed for special devices which are 
going to be used with IOEX access only. 

5 specifies (for a disk device only)thisas the system 
disk. The system disk receives the CP-R bootstrap, 
SP area, and any default allocations. If a SP area 
is defined, then that disk will become the system 
disk and this option is not required. 

The options ore: 

DEDICATE,value specifies various forms of restricted 
we declared for the device. 

A value of "S" specifies the device is a symbiont 
device. The device must be a card reader or a line 
printer. Note that symbiont devices may be used 
like nonshareable devices (see "J" value) when not 
In use by symbiont. 

A value of "F" specifies that the device may only 
be used by foreground programs. 

A value of "J" specifies that the device used may 
not be shared by more than one job. 

A value of "X" specifies that the device may only 
be used by IOEX, without request queuing. 



DEBUGfXxx specifies the hexadecimal address of 
an external interrupt level to be associated with 
the device when it is used as a DEBUG control 
console; meaningful only if device is TYndd. 

Note: The following options are applicable only for a disk 
device. 

SSEC,value specifies the decimal absolute sector 
number of the beginning of the disk space used by 
CP-R. Sectors are numbered consecutively starting 
with 0. The SSEC value must be less than the 
ENSEC value. The default SSEC value is 0. 

ENS EC, value specifies the decimal absolute sector 
number of the last sector number of the space used 
by CP-R. The ENSEC value must be greater than 
the SSEC value and less than or equal to the default 
value. The default value is shown in Table 32 and 
depends on the disk model number. 

NSPT,value specifies the decimal number of sectors 
per track. 

NWPS,value specifies the decimal number of words 
per sector. 

NTPC,value specifies the decimal number of tracks 
per cylinder. (In the case of fixed-heod disks, it 
is the total number of tracks. ) 

NCYL, value specifies the decimal number of cylin- 
ders available for use. (In the case of fixed-head 
disks, there is fust one cylinder. ) 

SS FT, value specifies the decimal value for a left 
shift which positions the sector number (right justi- 
fied in a word) to the correct position for a seek 
oddress. 

TSFT,value specifies the decimal value for a left- 
shift which positions the track number (right Justi- 
fied in a word) to the correct position for a seek 
address. 

C5FT,value specifies the decimal value for a left 
shift which position the cylinder number (right 
justified in a word) to the correct position for a 
seek address. 

area,value specifies the decimal number of sectors 
to be allocated to the designated area. 

If the remainder of the disk is to be allocated to an 
area, "ALL" can be input instead of a decimal 
value. 



The various forms in which this option can be writ 
are: 

System areas 



SP, value 
FP, value 



BP, value 
CK, value 



XA, value 
BT, value 
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Tabic 32. System Device Model Numbers and Parameter! 



Model 




Type 


CUST 






Number 


Mnemonic 


Number 


Size 


Device Type 




7202 


DC 


7 


8 


90 word RAD - 128 tracks 




7203 


DC 


7 


8 


90 word RAD - 256 tracks 




7204 


DC 


7 


8 


90 word RAD - 512 tracks 




7212 


DC 


7 


8 


High speed RAD 




7232. 


DC 


7 


8 


256 word RAD - 512 tracks 




3214 


DC 


7 


8 


NS RAD 




7242 


DP 


12 


14 


Double spindle disk pack 




7246 


DP 


12 


14 


Single spindle disk pack 




7270 


DP 


12 


14 


406 CYL 7242 




7275 


DP 


14 


14 


Disk 33 




7261 


DP 


14 


14 


45M byte disk pock 




7266 


DP 


14 


14 


90M byte disk pack 




7251 


DC 


7 


8 


DIABLO removable disk 




7252 


DC 


7 


8 


DIABLO fixed disk 




3242 


DP 


14 


14 


Cartridge disk 




3243 


DP 


14 


14 


Cartridge disk 




3277 


DP 


14 


14 


3333 disk 




3283 


DP 


14 


14 


6660 disk 




7362 


7T 


9 


6 


7T tope (37 IPS) 




7372 


7T 


9 


6 


7T tope (75 IPS) 




7322 


9T 


8 


8 


9T tape (75 IPS) 




7323 


9T 


8 


8 


9T tape (150 IPS) 




7332 


9T 


8 


8 


9T Porter 




7333 


9T 


8 


8 


9T Potter 




3325 


9T 


16 


8 


9T550 




3335 


9T 


16 


8 


9T550 




3344 


9T 


16 


8 


9T550 




3345 


9T 


16 


8 


9T550 




3346 


9T 


16 


8 


9T550 




3347 


9T 


16 


8 


9T550 




7440 


LP 


6 




LP 




7441 


LP 


6 




LP 




7445 


LP 


6 




LP 




7446 


LP 


6 




LP (BDP) 




7461 


LP 


6 




LP 




7462 


LP 


6 




LP 




7463 


LP 


< 6 




LP 




7464 


LP 


6 




LP 




7465 


LP 


6 




LP 




7466 


LP 


, 6 


f 


LP 




3461 


LP 


. 6 




NS LP 




3462 


LP 


6 


+S- 


NS LP 




3463 


LP 


6 


Sa 


NS LP 




3464 


LP 


6 , 


f 


NS LP 




3465 


LP 


6 




NS LP 




3466 


LP 


6 




NS LP 




7450 


LP 


6 




LP (Low Cost) 




7020 


TY 


1/ 


10 


TTY 




7012 


TY 


_ • » 


10 


TTY 




4591 


TY 


/'" 


10 


KSR35 -» 




4592 


TY 


1 


10 


DIABLO HYTYPE 




7120 


CR 




2 


CR 




7121 


CR 




2 


CR 




7122 


CR 


4 


2 


CR 




7140 


CR 


A 


2 


CR 




3132 


CR 




8 


NS 300 CPM CR 




3134 


CR 




8 


NS 600 CPM CR 
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Table 32. System Device Model Numbers and Parameters (cent. ) 



Model 




Type 


cusf 


1 


Number 


nfln#ff*OOIC 


Number 


Size 


Device Type 


3130 


at 


4 


8 


NS 1000 CPM CR 


7160 


CP 


5 


39 


CP 


7165 


CP 


5 


2 


CP (Low Cost) 


7062 


PR 


2 


6 


PR 


7020 


PR 


2 


8 


PR 


*7060 


PR 


2 


8 


PR 


7063 


PP 


3 


8 


PP 


7020 


PP 


3 


8 


PP 


7060 


PP 


3 


8 


PP 


7530 


PL 


13 


2 


PL 


7531 


PL 


13 


2 


PL 


NO 


NO 








No device (IOEX) 


NONE 


NO 








No device (IOEX) 


LDEV 


LD 


19 





Logical device 



Table 33. Disk Device Model Numbers and Parameters 



Model 












Number 


NSPT 


NTPC 


NCYL 


NWPS 


Description 


7202 


16 


128 




90 


90 word RAD - 128 tracks 


7203 


16 


256 




90 


90 word RAD - 256 tracks 


7204 


16 


512 




90 


90 word RAD - 512 tracks 


7212 


82 


64 




256 


High Speed RAD 


7232 


12 


512 




256 


256 word RAD- 512 tracks 


3214 


11 


256 




256 


NS RAD 


7242 


6 


20 


200 


256 


Double spindle disk pack 


7246 


6 


20 


200 


256 


Single spindle disk pack 


7270 


6 


20 


400 


256 


406 CYL 7242 


7275 


11 


19 


404 


256 


Disk 33 


7261 


11 


20 


200 


256 


45M byte disk pack 


7266 


11 


20 


404 


256 


90M byte disk pack 


7251 


16 


407 


1 


90 


DIABLO removable disk 


7252 


16 


407 


1 


90 


DIABLO fixed disk 


3242 


7 


2 


400 


256 


Cartridge disk 


3243 


7 


2 


400 


256 


Cartridge disk 


3277 


12 


19 


404 


256 


3333 disk 


3283 


12 


19 


808 


256 


6660 disk 



Symbiont 



IS, value [, fsize] 

OS, value [,fcize] 

where "fsize" defines the size of symbiont 
area files in records. The default "fsize" is 
25 records for the input area and 200 records 
for the output area. Note that the maximum 
number of files allowed for a job in either the 
IS or OS area is 256, therefore, fsize should 
be selected so that this maximum will never 
be exceeded for a single Job. 



User areas 



uu, value 



Pi 

B 

F 



where uu is a two-character 
name of the user defined 
area to ty allocated. 



Note that for the data areas uu, a type may 
be given to specify usage and write protection. 
This may be one of 

P public 

B background (this is the default). 

F foreground 

S system 
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Publ ic areas hove no sotrware writ* protection; 
any talk may write to them. They provide a 
pool of space lor file operation* which omit 
th« specification of a disk aroa nam*. 

Tho remaining three areas or* profoctod from 
occidental access by requiring that the area 
name be given explicitly. 

Background areas have no other protection; 
any task may write to them. 

Foreground areas are protected from the back- 
ground unless the "SY" key-in is in effect. 

System areas are protected from both bock- 
ground and foreground unless the "SY" key-in 
is in effect. 



A 7202 RAD, device number 90, on IOP number 1, to be 
used as the system disk storting on sector zero, with default 
sizes for the SP, CK, end BT areas, and the input sizes for 
the FP, 01, and 02 areas. 



:ALL0BT The :ALLOBT command establishes the perma- 
nent sizes of the GO and OV files contained in the back- 
ground temp area, i.e., the system default sizes of these 
files at execution time. 

The :ALLOBT command has the form 



r 



where 



:ALLOBT (file nome,size)[, (file name,size)j 



The SP, CK, and BT areas will be allocated by de- 
fault if not specified. The CK and BT areas may 
be removed by specifying a size of zero sectors. 

Inclusion of either a [,S] option or a [5P,valueJ 
defines the device as a system disk and any of the 
abovedefoultallocationswill be made on this disk. 

The default size allocated for the SP area is 1500 
sectors. The default size allocated for the BT area 
is 'ALL'. The default size allocated for the CK 
area is large enough to hold all of memory. 



Examples: 

/:DEVICE CRA03,7120 



Higher performance cord reader, device number 3, on IOP 
number 0, undedicated. 



r 



:DEVICE LPA02,7450,(DEDICATE,F) 



Lower performance line printer, device number 2, on IOP 
number 0, dedicated to the foreground. 



.-DEVICE NOC09,NO 



Nonstandard device, device number 9, on IOP number 2, 
dedicated to IOEX. 

/:DEV1CEDCB90,7202,S,(FP,15),(D1,10,F),(D2,10,B) 



file name specifies the name of the file, which must 
be either GO or OV. 

size specifies the decimal number of sectors to be 
allocated tor the specified file. The size input 
becomes the permanent size for the specified file 
and overrides the SYS GEN default sizes given in 
the "Background Temp Area" subsection. 



tffOEF The :MDEF commend defines new models of 

peripheral devices. This allows SYSGEN to accept :0EVICE 
commands for types of devices not included in Tobies 32 and 33. 

The :MDEF command has the form 



r 



where 



MDEF mmmm [,(option)][, (option)] . . . 



mmmm specifies the model number. Redefinition of 
model numbers is also allowed. 

The options are : 

MNEMONIC, YY specifies the two-character mne- 
monic used in the yyndd format. 

SIMILAR, mmmm specifies a similar model number 
from which all characteristics are copied. Addi- 
tional options may then be used to modify selected 
characteristics. 

TYPE,n specifies the decimal type number placed in 
DCT4. (See CP-R Technical Manual 90 30 88.) 

SDBUF, n specifies the decimal number of words 
allocated as a buffer. This is only valid when the 
system h assembled with 'S1DEBUF set. 

0CT3,x specifies the hex value to be placed in 
DCT3. (See CP-R Technical Manual 90 30 88.) 
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CUST,n specifies the decimal number of words 
allocated as a command list buffer. 



PREHAND, e c o o e ac e specifics the EBCDIC nam* of 
the I/O pre-handler to be used for this device . 



P05THAND, eeeeeeee specifies the EBCDIC name 
of the I/O post-handler to be used for this device. 

IOTX, n specifies the decimal value of the internal 
SVSGEN I/O table index. (See CP-R Technical 
Manual 90 30 88.) 

The following options are valid only for disk devices. 
(Mnemonic = 'DC' or 'DP'.) The/ establish default disk 
characteristics, and ore identical to the disk options on the 
rDEVICE command. 



NSPT,n " 




NTPC,n 




NCYL,n 




NWPS,n 


' see rDEVICE command 


SSFT,n 




TSFT,n 




CSFT,n 





OUT, value specifies the hexadecimal address of the 
COC output interrupt. The default is 61. Output 
must have a lower priority than input. 

IN,vrlue specifies the hexadecimal address of the 
COC input interrupt. The default is 60. Input 
must have higher priority than output. 

LINES, value specifies the decimal number of lines. 
The default is 8. 

BUFFERS, value specifies the decimal number of 
4-word buffers necessary for COC I/O usage. The 
default value is the number of lines times 3. The 
recommended value is the number of users times 3. 

RING, value specifies the decimal number of words 
for the COC input buffer. The default is 2 bytes 
per line for the first 30 lines plus 1 byte per line 
above 30. 

33, value, specifies the decimal line numbers 

that ore attached to Model 33 Teletypes. 

35, value, specifies the decimal line numbers 

that are attached to Model 35 Teletypes. 

37, value, specifies the decimal line numbers 

that are attached to Model 37 Teletypes. 



MOD The :MOD commands allow patches to be made 

to SYS GEN itself. 



The :MOD command has the form 

A 



:MOD (SYSGEN,addr)[,xxxxxxxx][,xxxxxxxxx] 



where 



7015, value, . . . specifies the decimal line numbers 
that are attached to Xerox Model 7015 keyboard 
printers. 

Model 33 is the default terminal. 

HARDWIRE, value,.. specifies the decimal line 
numbers that are hard wired to terminals. Lines 
which are "hardwired" will not be timed out nor 
will they be logged on automatically. 



addr is the absolute hex address of the start of the 
patch. 

xxxxxxxx is the absolute hex value to be stored 
starting at addr. Successive values are stored in 
successive addresses. 



RATE, rate, value, . specifies the "rate" in decimal 
characters per second and value specifies the line 
numbers in decimal associated with the "rote". 
The rate must be in the range 1 to 255. One RATE 
option is used for each terminal speed on the COC. 
The default "rate" is 10. 



'.COC The :COC command specifies the characteristics 

associated with the COC device. The sCOC command has 
the form 



NONTJE, value, . . . specifies the decimal line num- 
bers thatare not to be logged on as TJE lines. This 
allows the user to declare lines whose only purpose 
will be to be road or written. 



/' 



rCOC (option), (option), . . . 



The options are: 



DEVICE, ndd specifies in hexadecimal, the 
of the COC device. 



The following restrictions apply to multiple :COC commands. 
All COC input interrupts must be higher than oH COC out- 
put interrupts. All COC input interrupts must fall within 
one interrupt group and all COC output interrupts must fall 
within one group. The :COC commands must be ordered 
and sequential with respect to the DIO addressing logic 
and must begin with zero. COCO input interrupt must be 
the highest of all COC interrupts. 
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;STDLI The jSTO LB command defines all standard system 
operational label assignments fer the generated system and 
all standard war operational labali end their assignments. 
Not* that operational labels cannot be assigned to disk files 
during SYSGEN. The STDLB command must be input follow- 
ing the :DEV1CE commands. 

The &TDLB command has the form 

A 



£TDLB (label ( name)[ / (label,neme). . .] 



(CTWT The £TINT command specifies the interrupts 
to which the CP-R Dispatchers and Control Task is to 
be connected; the highest address used for interrupts; and 
the interrupt that will be used for deferred I/O interrupt 
processing. 

The rCTINT c o m m and has the form 

St 



:CTINT[(CT,address), . . w(HI,oddress)][,(lO,address)] 



where 



label specifies a system operational label or a user 
operational label. All user operational labels must 
consist of two alphanumeric characters. Any sys- 
tem operational labels not specified on a :STDLB 
command will receive by default a permanent as- 
signment of zero. The order of the user's labels 
determines a label's position in the operational 
label table, and therefore determines the OPLB 
value that might be present in a user OCB (see the 
table in the example below). No label will be 
allowed that is the same as a Background Temp 
file name (GO, OV, X1-X9) or the same as a 
disk area. 

name specifies a physical device name to which 
the operational label is permanently assigned, a 
numeric zero, or a previously assigned operational 
label. In the latter case, the operational label 
will be assigned to the same device as the label 
to which it is assigned. If "0" is specified, the 
permanent assignment is zero. 

The :STDLB command example 



:STDLB (C,TYA01 ),(OC,C),(LO,LPA02),(LL,LO), 

C 



-(BI, CRA05), (SI, CRA05),(SO, CRA06),(XX, CRA05), 



c 



(ZZ,LPA02) 



would set up the operational label table given below. 







OPLB 


Permanent 




Label 


Index (10) 
1 


Assignment 




re 


TYA01 




OC 


2 


TYA01 




LO 


3 


LPA02 




LL 


4 


LPA02 


Standard 


DO 


5 





System 


CO 


6 





Oplabels 


BO 


7 







CI 


8 







SI 


9 


CRA05 




BI 


10 


CRA05 




I so 


11 




User 


XX 


12 


CHAOS 


Oplabels 


zz 


13 


LPA02 



CT, address specifies the hexadecimal address of the 
higher-priority one of a pair of odjacent interrupts 
to be used by CP-R for dispatching secondary tasks. 
As many of these pairs as desired may be specified 
(within the constraints of the existing interrupt 
levels). The lowest-level dispatcher (for the CP-R 
Control Task) will use the lowest-level interrupt 
specified and a 'null' level below it, i.e., the 
lowest-level "pair" defines only one actual inter- 
rupt level. This level will run the Control Task and 
the background task. If "address" has the value zero, 
no interrupt is available for the Control Task. In 
this case, SYSGEN will specify the Control Panel 
interrupt and its use will be shared by the monitor. 
The default value for the Control Task Interrupt is 
location X'61 '. Note that if multiple CT parameters 
ore input, then they must input in priority order 
(i.e., highest dispatcher first). 

HI,address specifies the highest address, in hexa- 
decimal, needed for an interrupt. SYSGEN will 
assume that all memory locations greater than HI 
are unused as interrupts and will attempt to allo- 
cate monitor tables in this area. The default 
value is X'13F'. Normally, CT and HI would 
have the same value . 

IOfOddress specifies the absolute hexadecimal in- 
terrupt location to which the bookkeeping asso- 
ciated with an I/O interrupt will be deferred 
(cleaning up the interrupting operation and get- 
ting something else going). If "address "is 0, the 
highest CT interrupt level will be used. The value 
of address in all other cases must be equal to or 
less than the CT address. If the IO parameter is 
not present, the aforementioned bookkeeping will 
take place at the I/O interrupt level « 

By using this parameter, a user may*defer I/O 
processing to an external level below that of his 
task(s) which require this high response. 



'.IN TLB The :INTLB command provides the capability of 
associating a label with an interrupt location. The label 
may then be used in system service calls in lieu of an ac- 
tual interrupt address. 
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The :INTLB c o m mand hot the farm 

XlNTU (lobel,loc)[,(label,locX. . .,(labe1,loc>] 



where 

label specifies a two-charocter alphanumeric label. 

lee specifies the absolute hexadecimal interrupt 
location to be associated with the label. 

Duplicate labels are diagnosed as errors. The key-in INTLB 
may be used to change the assignment of the label from one 
interrupt location to another. 



iPUNCH The tPUNCH command specifies thata reboot- 

able version of SYS LOAD is to be punched after SYSGEN 
has read its last control command. 

The :PUNCH command has the form 



A 



PUNCH yyndd,mmmm 



I where yyndd,mmmm specifies the device (e.g., CPA04)on 
which the rebootable copy of SYSLOAD is to be punched. 



The :SITE command has the form 
/:SITE text 



where 
SITE 



ttxf is up to 56 bytes of text which is used to 
uniquely identify the site for which the SYSGEN 
was mode. 



•.COMMENT The £OMMENTcommand allows insertion 

of comment lines into a SYSGEN control deck on command 
Ikies which have no other effect. 

The COMMENT command has the form 



r 



iCOMMENT any test string up to column 80 



:SYSL0 The :SYSLD command also signals the end of the 
control commands to SYSGEN. The :SYSLD command causes 
SYSGEN to output the rebootable deck of CP-R, if re- 
quested, and then exit to a SYSLOAD entry where no fur- 
ther control command input is required. 



The &Y5LD command has the form 



'FIN The :FIN command signals the end of the control 

commands for the SYSGEN phase. Upon reading the :FIN 
command, SYSGEN will punch a rebootable version of 
SYSLOAD, output the SYSGEN-phase map if requested, 
and continue to SYSLOAD. 

The :FIN command has the form 

/:FIN[MAP] 



where 



MAP specifies that a MAP is to be output on the 
tame device being used to log the SYSGEN con- 
trol commands. If no output device was speci- 
fied on the :SYSGEN command, the MAP is output 
on TYA01. 



:SITE The sSITE command, if present, is used In fob 
header identification and for error logging purposes. 



:SYSU>[(lN,yyndd^tmmmi)]r,(OLn",yyndd,itimmm)] ■ 



ALL 

FAST 

UPD 

[OVR 



[,(V,xxx)] [ (MAP[, vyndd,mmrrm])] 



IN specifies the device to be used for loading the 
control-program modules. The device must be 
either CR, 9T, or 7T. See the SYSGEN command 
for the yyndd and rnmrnrn definitions. The default 
is the bootstrap device. 

OUT specifies the device to receive a hard copy 
of the CP-R disk bootstrap. If the system disk 
allocation starts on sector zero, this field is op- 
tional; otherwise, an output device must be speci- 
fied. The output device must be either CP, 
9T, or7T. 
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ALL 
FAST 
UPD 
OVRJ 



specifies Hi* SYS LOAD mod* of operation. 
The "ALL" and "FAST" parameters Indicate 
that all defined area of the disk are to be 
Initialized to zero. The "UPD" parameter indi- 
cates that existing data on the disk must be saved 
and only the new version ofCP-R should be output 
to the disk. The "OVR" parameter is identical to 
"ALL" and "FAST", except that no clearing or 
referencing of any area will take place. See 
"SYSLOXD", below, for a further description of 
these options. The default value for this poram- 
is "UPD". 



specifies the version number of the system being 
loaded. Up to four alphanumeric characters can 
be input for the version. The version will be 
logged on LL at the start of each fob and logged 
with each postmortem dump. 



MAP specified that a MAP is to be output at the 
completion of SYS LOAD on the yyndd device and 
on the file CPRMAP which will be created for it 
in the SP area. The device type specified must 
be either LP or TY. The default is the 'OUT' de- 
vice defined on the :SYSGEN command. 



See the SYS GEN control command for a detailed descrip- 
tion of yyndd ,mmmm . 



SYSLOAD 

When the SYSGEN phase has been completed, or when the 
rebootable SYSLOAD deck punched by SYSGEN has been 
loaded, control is transferred to SYSLOAD. SYSLOAD loads 
the required CP-R modules as determined by the SYSGEN 
input parameters and outputs these to the disk. It then out- 
puts the disk bootstrap and the System Program area directory 
to the disk. When SYSLOAD terminates it enters an idle 
state. If necessary, the user can now load the system and 
user programs on the disk by following the sequence outlined 
later in this chapter. If a :SYSLD command was not input 
to SYSGEN or input after rebooting the SYSLOAD deck, 
SYSLOAD will initially output the following messages on the 
TYA01 device: 



CP-R SYSLOAD INPUT OPTIONS 



The options input on the TYAOl device must be made via 
the :SYSLD command. 

All writes made on the disk during the SYSLOAD phase will 
be checked to ensure that the data was correctly recorded. 



MAP OPTION 

The MAP option allows the listing of a map of both memory 
and disk allocation. The memory allocation is displayed as 
two portions. The first is titled 'CP-R TABLE ALLOCATION'. 
It is again divided into two parts. The fir.it is a fisting of 
tables allocated during the SYSGEN process itself. The 
second is a listing of the symbols defined in the permanently 
resident modules of the system. The second major part is 
titled 'CP-R PROGRAM ALLOCATION' and is a listing of 
the overlay entry and exit points. 

The disk allocation lists the area name, number, starting 
sector number, ending sector number, size and protection 
for all areas included in the SYSGEN. 

SYSLOAD loads three groups of CP-R modules in the follow- 
ing sequence: optional resident routines (FPSIM, DECS1M, 
CVSIM, BYTSIM); mandatory resident modules; the overlays 
and JCP. 



The three groups of modules must be loaded in the stated 
order, but (for example) individual CP-R overlays need not 
be in any special order. All these routines can be input as 
one package and SYSLOAD will select and load only the 
routines that were requested during SYSGEN, making it un- 
necessary to rearrange the decks of modules if requirements 
change. 

Each monitor module, in absolute object form, is identified 
to SYSLOAD via a DEF item, and any module not required 
is passed over. EODs are allowed between modules, and 
the final module in a group must be followed by an EOD. 
If all the required modules are not present in a group, 
SYSLOAD outputs the following alarm on TYAOl: 



MISSING ID name1,name2,... 



where name n is the name of the missing routine, the name 
being indicated by the single DEF item in the module. 
SYSLOAD assumes the missing routines are not required and 
continues. 

SYSLOAD writes the required overlays on the disk as they 
are loaded and sets up the information needed to enter the 
overlays in the OVI table. Modules that are not overlays 
will be leaded directly into the resident-monitor memory 
image and later written out with the resident portion. 

When the SP-area directory is written on the disk by 
SYSLOAD, it will contain entries for four files named 
CPRFILE, JCP, CPRMAP, and RADBOOT. RADBOOT is 
the file that contains a copy of the disk bootstrap, the op- 
erational version of which being the only program on the 
disk not contained within a disk area. Therefore, it cannot 
be accessed if a disk dump or save is required, and for this 
reason a copy of the bootstrap is kept in an SP-area file. 

The CPRFILE, JCP, CPRMAP, and RADBOOT files will be 
the first four files in the SP area. The CPRFILE will include 
any patch or expansion area that the user has requested . 
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After CP-R and the SP directory are output to the disk, 
SYSLOAD sets up the appropriate command list in the boot- 
strap to enable the bootstrap to reload CP-R from the disk. 
The bootstrap is then written both into the RADBOOT File 
and onto the starting sector of the system disk (STTRACK 
option on :DEV1CE command). 

If the system disk allocation starts at other than sector zero, 
a copy of the bootstrap is written on the device specified 
by the OUT keyword on the :SYSLD command. The user 
can then boot in CP-R by loading the "hard" copy of the 
bootstrap. This permits having more than one monitor sys- 
tem on disk and still being able to boot in CP-R by reading 
in a hard copy of the bootstrap. 



All OPTION 

The ALL option specifies that a complete system load is to 
occur and that all disk areas should be initialized. The ALL 
option is necessary for the initial SYSLOAD or if the disk 
allocation has changed so drastically that all areas on the 
disk have moved. SYSLOAD will zero out all defined areas 
of the disk. 



FAST OPTION 

The FAST option is identical to ALL except that only the 
first sector of each area is cleared to zeros. For disk packs, 
this will provide a considerable saving in the time required 
for SYSLOAD. The RADEDIT may be used subsequently 
to clear any areas that the user specifically requires to be 
cleared to zeros. 



OVERRIDE OPTION (OVR) 

The override option is identical to the ALL and FAST options 
except no disk area referencing or clearing takes place. 
Only area SP will be written to. This permits the user to 
add new disk areas while leaving other areas intact, and 
also permits one CP-R installation to generate a system for 
another CP-R installation with different disk areas and/or 
different secondary storage devices (only the SP areas must 
match) . 



UPDATE OPTION 

The UPD option can be used whenever there Is an existing 
system on the disk, and the user wishes to bod a new ver- 
sion of the monitor or change some of the SYSGEN param- 
eters. It is not necessary to go through a SYSGEN to load 
a new version of the monitor. It is only necessary to load 
the reboo table SYSLOAD deck and go through a normal 
SYSLOAD, specifying the "UPD" option on the rSYSLD 
command. 



To change any SYSGEN-defined parameters, it is necessary 
to input the complete set of SYSGEN control commands. 
That is, there is no attempt to merge the new version of the 
monitor with the existing version on the disk. 

If the user does not want to disturb any of the disk areas, 
the areas must be input with the same size and in the same 
order as the initial SYSGEN. If the size of a disk area has 
to be changed or a new disk area has to be added, all disk 
areas (except CK or BT) must be reloaded from the first 
changed area to the end of the disk. Therefore, the areas 
most subject to change in size should be allocated to the 
end of the disk so that the minimum number of areas are af- 
fected by a change . An area that must be moved can be 
saved and restored intact by using the RADEDIT Save and 
Restore functions. It is normally to the user's advantage to 
take the default size and allocation for the CK and BT areas 
since these are automatically allocated at the end of the 
disk and may be changed without affecting any other area. 

To inform the user as to which areas on the disk have moved, 
SYSLOAD reads in the disk bootstrap from the existing ver- 
sion, determines where the monitor is located on the disk, 
and then inputs the Master Directory from the existing ver- 
sion . If the disk address is changed for any of the S P, FP, 
BP, XA, or Dn areas, SYSLOAD outputs an appropriate 
alarm, requests permission to continue, and then zeros out 
the first sector in each area that has moved, thus effectively 
erasing all data in the area. 

The old system is examined to determine which disk areas 
have changed their allocation. If the size, location, or 
device have changed, an alarm is output and the operator is 
requested to indicate that the process should continue or not. 

The size of the old CP-R file is examined to determine if it 
has grown larger than the previous system. If it has, then 
the SParea must be completely reloaded in the same manner 
as a FAST or ALL option. This is because the CP-R file is 
the first file in the area. 

If the first word address of background is different in a new 
version from that of the existing version, the alarm 



RELOAD, BGKG, PROGRAMS 



is output. All programs that execute in the background, 
both system processors and user background programs, would 
then have to be reloaded and absolutized for their new core 
execution location. 

If SYSLOAD determines that the new version is completely 
compatible with the existing version, the. message 



RELOAD, NOTHING 



is output. 

After typing the necessary RELOAD alarms, SYSLOAD 
loads the optional resident routines, the mandatory resident 
modules, and the overlays as described under the ALL option. 
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AILOCATION OF SPARE* 



CP-R will type the massage 



When SYSLOAO has executed, the Systems Program area of 
the disk will have the following layout: 



SP Directory: 

Entries for CPRFILE, JCP, 

CPRMAP, RADBOOT 



CPRFILE 

(Resident monitor and CP-R 

Overlays) 



TEL File (ifTJE is included) 



JCP File 



CPRMAP File 



RADBOOT File 



Unused SP AREA 



Relative to sector 
Sectors 1 to m 

Sectors m + 1 to n 

Sectors n + 1 to p 
Sector p + 1 

Sectors (p + 2) to q 



SYSGEN AND SYSLOAD ALARMS 

All alarm messages that can be output during SYSGEN and 
SYSLOAD are defined in Table 34. 



LOADING SYSTEM PROCESSORS AND 
USER PROGRAMS 

After SYSLOAD completes its operation, it will read CP-R 
into memory from secondary storage and transfer control to 
the CP-R initialization routine. 



XEROX CP-R VERSION xxxx 



and execute a WAIT instruction . The operator should then 
place his job stack in the C device to load the appropriate 
programs, perform an interrupt, and key in a "C". Control 
wi 1 1 be transferred to the Job Control Processor to read the 
first control command. 

If one of the ALL, FAST, or OVR options is specified to 
SYSLOAD, the system processors must be rebuilt. Addition- 
ally, if the UPD option is specified, but a message indicates 
the need to reload the SP area or system processor alternate 
area, or relink background programs, part or all of the sys- 
tem processors must be rebuilt. 

The CP-R initialization routine provides the files in which 
the OLOAD and RADEDIT processors will reside, in the SP 
area (or system processor alternate area, if one is defined). 

First, the OLOAD processor is linked by the JCP Loader, in 
a single-level overlay structure. OLOAD b then used to 
link the more complicated overlay structure of RADEDIT. 

These two processors ore then used to allot and link other 
processors and utility files. 

Figure 31 shows an abbreviated control deck for linking the 
system processors from ROMs on oplabel TO. 



Table 34. SYSGEN and SYSLOAD Alarm Messages 



Alarm 


Meaning 


Recovery Action 


BI CKSM ERR 


Non-I/O Alarms 

A checksum error has occurred in the 
object module being input. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


BI SEQ ERR 


A sequence error has occurred in the 
object module being input. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the proftTem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


BT AREA TOO SMALL 


The space allocated to the BT area 
is insufficient to hold the default 
sizes of the GO end OV files. 


There is no recovery from this condition except 
to rerun the SYSGEN to either allocate more 
disk space for the BT area, or reduce the default 
size of the GO and/or OV file. 
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Table 34. SYSGEN and SYSLOAD Alarm Messages (cont. ) 


Alarm 


Meaning 


Recovery Action 


CK AREA TOO SMALL 


Non-I/O Alarms (cont.) 

The amount of disk space allocated 
for the CK area is not sufficient to 
hold the initial size of background. 


Either the disk areas must be reallocated (requires 
a rerun of SYSGEN) or a checkpoint cannot be 
done with the initial size of background. 


OUP. DEF, xxxxxxxx 


The same DEF has been encountered 
in two object modules, probably indi- 
cating that two copies exist of the 
same object module. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types "NO" the process will be aborted. 


EOF BEFORE END ITEM 


During the loading of an object mod- 
ule, SYSLOADhas encountered a mis- 
placed EOD or EOF. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


ERR,CONTROL BYTE = xx 


The xx control byte in the object mod- 
ule being loaded cannot be processed 
by SYSLOAD. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


ERROR ITEM xx 


An error has occurred in item xx of 
the last control command input. Every 
item (except the :), followed by a 
blank or a comma, is counted in deter- 
mining the one in error. If xx is one 
greater than the last item input, a 
nonoptional item was not input. 


Control will be transferred to TYA01 to allow the 
user to correct the error. Unless stated otherwise 
(where the individual commands are described) 
all items preceding the incorrect one have been 
processed, and only items starting with and fol- 
lowing the incorrect one need by input. If the 
user desires to input nothing from TYA01 and to 
transfer control bock to the original input de- 
vice, a single colon (:) should be input on TYA01. 
If an error occurs on a continuation card, a card 
containing a control command must follow. 


ILL. DEF, xxxxxxxx 
ILL. REF, xxxxxxxx 


The specified DEF or REF is not rec- 
ognized by SYSLOAD during the 
loading of an object module. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


INPUT ORDER ERROR 


The :MONlTOR, RESERVE, or 
:DEVICE command for the system disk 
has been input in the wrong order. 


Catastrophic error. Rerun SYSGEN from the 
start. 


MISSING ID 


See ALL option. 


See ALL option. 


NO SYSTEM DISK 


No disk has been designated as the 
system disk. 


Catastrophic error. SYSGEN must be rerun from 
the start. •* 


OBJ. MOD. NOT RECOG. 


The current object module being 
loaded by SYSLOAD is not recog- 
nized by SYSLOAD. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO* the process will be aborted. 


OC LABEL NOT ASSIGNED 


The OC operational label has not been 
assigned to a typewriter device. 


There is no recovery from this error. The OC label 
must be assigned in order for the system to function . 
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Table 34. SYSGEN and SYS LOAD Alarm Manages (cont. ) 



Alarm 


Meaning 


Recovery Action 


DISK OVERFLOW 


Non-l/O Alarms (cont. ) 

The total number af tracks input on 
the :DEVICE command have exceeded 
the total available size. 


The :DEVICE command must be completely re- 
input, with the sizes of the areas appropriately 
changed. 


RELOAD XX AREA 
RELINK BACKGROUND 

PROGRAMS 
RELOAD NOTHING 


These messages are output when an 
update option was used on the 
:5YSLD command. They indicate 
various incompatibilities between 
the new and the old systems. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


UNABLE TO FIND OLD 
CP-R 


During an update run, SYSLOAD was 
unable to locate the old version of 
CP-R on the disk. 


The message 'CONTINUE?' will be output. The 
operator should type 'YES' or 'NO' to indicate 
what to do. If he types 'YES', the problem will 
be ignored and the process will continue. If he 
types 'NO' the process will be aborted. 


yyndd BUSY 
lOP n BUSY 


I/O Alarms 

The indicated device or IOP has re- 
turned a busy status. 


SYSGEN will keep attempting the I/O opera- 
tion. Probably indicates a hardware problem. 


yyndd ERROR, SB =xxxx 
yyndd PARITYJRK =xxxx 


A transmission error has occurred with 
the indicated device. SB=xxxx indi- 
cates the contents of the TIO status 
bytes in hexadecimal. If a parity oc- 
curs while clearing the disk, the bad 
track, as returned in the sense order, 
is also logged in hexadecimal. 


SYSLOAD continues attempting the I/O opera- 
tion, unless a parity has occurred while clear- 
ing the disk. In this case, this alarm and the 
parity alarm will be logged and the disk clear- 
ing will continue. 


yyndd FAULT, 
TDV = xxxx 


A hardware fault has occurred on the 
indicated device. The TDV status 
byte is also output in hexadecimal. 


SYSGEN continues attempting the I/O opera- 
tion. Repair and ready the indicated device. 


yyndd MANUAL 


The indicated device is in manual 
mode. 


Ready the device. 


yyndd UNRECOG 


The device indicated by yyndd is un- 
recognized by the system. 


SYSGEN will enter a "WAIT" state. Probably 
an invalid device number was input, and the 
SYSGEN will have to be rerun from the start. 
If the "WAIT" state is cleared, SYSGEN will 
retry the I/O operation. 


yyndd UNUS. END, 
TDV = xxxx 


An unusual end status has been re- 
turned from the indicated device. 
The TDV status byte is also logged 
in hexadecimal. 


SYSGEN continues attempting the I/O 
operation. 


yyndd WRT PROT 


The indicated magnetic tape or disk 
is hardware write-protected. 


For a magnetic tape, insert a write ring and 
ready the tape . For a disk, reset the hardware 
Write Protect switch and then clear the "WAIT" 
state so SYSLOAD can retry the I/O operation. 
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JOB ELD.FROCESSORS. 

ATTEND 

STELE (BI,TO) 

PAUSE KEYIN SYC 

ALLOET (FILE, GO) ,(FSI,0), SAVE 

ALLOET (FILE, OV),(FSI,0), SAVE 

ALLOET (FILE, X1),(FSI,t>00), (RSI, 30), (FOR, B), SAVE 

LCAD (OUT,SP,OLOAD),(SEGS,6),MAP 

OLOAD (FILE, SP.RADEDIT) , (TEKP, 50), (MAP, PFOG), LIE, FORE 

FOOT (OPLB.BI.EOD) 

SEG (LINK, 999) , (EXLOC, 10000) .NONE 

RES (XEPEND, 20000) 

SEG (LINK, 1000, ONTO, 999), (EXLOC, 8000), (OPLE, EI, ECD) ; 

(SHARE, SYS), (ACCESS, RX),lLOAD 
SEG (LINK, 1001, ONTO, 1000), (OPLB.BI.EOD), (SHARE, SIS), (ACCESS, FX) 
SEG (LINK, 1002, ONTO, »000), (OPLB.BI.EOD), (SHARE, SYS), ( ACCESS, RX) 
SEG (LINK, 1003, ONTO, 1000), (OPLE, EI, EOD), (SHARE, SYS), (ACCESS, RX) 
SEG (LINK, 1004, ONTO, 1000), (OPLE, BI, EOD), (SHARE, SYS), ( ACCESS, RX) 
RADEDIT 

ALLOT (FILE, SP, CRASH), (RSIZE, 256), (FSIZE, 514) 
ALLOT (FILE, SP.ERRFILE) , (RSIZE, 1 6), (FSIZE, 100), (FORMAT, B) 
ALLOT (FILE,SP,AI),(RSI,20),(FOR,B),(FSI,100) 
ALLOT (FILE,D1,AL),(RSI,e),(FOR,B),(FSI,500) 
ALLOT (FILE, SP, EDIT), (FSI, 100), (RSI, 256) 
OLOAD (FILE, SP, EDIT), (TEMP.25), (LIB), (KAP.PRO), FOR 
ROOT (OPL,EI,EOD) 

SEG (LIN, 1066 ) ,ILOAD, (OPL.BI, EOD), (SHARE, SYS ),(ACC,RX) 
RADELIT 

ThUNCATE (FILE, SP, EDIT) 
SQUEEZE SP 



Figure 31 . Linking the CP-R System Processors (abbreviated) 
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16. HARDWARE CONFIGURATION GUIDELINES 



MTRODUCTION 

This chapter it intended as an aid to the system manager in 
selecting the proper hardware for his CP-R system. A 
reasonable selection of hardware can be made only on the 
basis of a thorough understanding of the particular appli- 
cation's requirements. Requirements that must be evaluated 
include the number of discrete interrupt levels required, the 
amount of secondary storage required for programs and data, 
memory requirements to satisfy resident foreground needs 
and concurrent batch (if desired), and peripheral equip- 
ment requirements for the data media desired. Figure 32 
illustrates the lowest-cost minimum CP-R configuration. 
Figure 33 illustrates a more typical CP-R configuration. 



HARDWARE INTERRUPT REQUIREMENTS 

The maximum number of primary foreground tasks that are 
expected to operate concurrently determines the number 



of hardware-interrupt levels required, in addition to those 
needed by CP-R itself. The association of an interrupt level 
with a task establishes the priority of the task. The task's 
worst-case response time (to an external stimulus) is depen- 
dent upon the maximum CP-R inhibit time and the possible 
activity of higher priority tasks. Tasks that are prioritized 
above the I/O interrupt task must contend only with the 
CP-R typical inhibit of 100 usee and possible interference 
among themselves. (With error logging, the worst-case in- 
hibit time is 400 usee. ) 

Tasks associated with an interrupt priority higher than I/O 
cannot utilize any CP-R services that involve I/O; thus 
these higher interrupt levels are typically associated with 
high priority tasks that utilize the Direct I/O interface 
with SIUs and defer CP-R services to related, lower-priority 
tasks. 

Tasks that operate at a priority lower than the I/O interrupt 
level can utilize all CP-R services including I/O. Any 
number of these tasks may operate concurrently up to the 



16K 

Memory 



I6K 
Memory 



Xerox 550 

Central Processing Unit 



See Product Description 
for Memory Port 
Requirements 

0) 



Multiplexer 
]/0 Processor 



Disk Control 



K/P 4591 




Disk 



Notes: 

(1) System operates in 32K. (Supports up to 256K. ) 

(2) 3332 Magnetic tape units. 



Figure 32. CP-R Lowest-Cost, Minimum Configuration 
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8762A 
16K Memory 



Xerox 

Sigmo 9 
CPU 

8710 



Core Memory (32K) 



Memory Map and Protection 



Floating Point 



Register Block (1) 



External Interrupts (12) 



Real-Time Clocks (2) 



MIOPwith 16 Channels 

Plus 8771 Four-Byte Interface 



Keyboard Printer Control 



1762 B 
16K Memory 



7440 

Line 

Pri nter 



7236 
Controller 



7232 
(6.2 mb) 



K/P 
7012 



£ 



7122 
Card Reoder 




Figure 33. Typical Configuration 



number of available lower-priority hardware interrupts mi- 
nus two for each CP-R dispatcher level. (Each CP-R 
dispatcher requires the two hardware interrupt levels. ) A 
dispatcher may be connected to the lowest interrupt level, 
in which case, the other interrupt level is null. For tasks 
below the I/O level, the I/O interrupt can cause an inter- 
ference of up to approximately 500 microseconds. 



There is on option in CP-R to allow I/O end-action and 
I/O cleanup to be postponed to a level lower than the I/O 
level. The user specifies this hardware level, if desired. 
Primary tasks between this level and the \/0 level have 
less interference (due to l^O interrupt activity). 



If 7611 (COC) equipment is available for the terminal job en- 
try system, two external interrupts are required for each 76 1 1 . 

Although external hardware-interrupt groups on a Sigma sys- 
tem can be arranged in any priority order the user desires, 
CP-R requires of a Sigma configurof iorf*(and assumes) that 
group 2 is higher than group 3, group 3 higher than group 4, 
and so forth. Therefore, if any one group is to be above the 
I/O level in priority, it must be group 2. 

The same hardware interrupt can be used "serially" by dif- 
ferent tasks, but only one can be connected to a given 
interrupt at any one time. Table 35 gives a summary of the 
Sigma 9 and Xerox 550 interrupt structures. 
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Table 35. Interrupt-Structure Summary 



Maximum Number of External interrupts 


Clocks' 


Priority Levels > I/O 


Priority Levels < I/O tt 


Sigma ?: 

224 standard and optional combined. 


2 standard 
2 optional 


208 optional 


224 optional 


Xerox 550: 

48 standard and optional combined. 


4 standard 


12 optional 


36 optional 


Clock 4, set at a frequency of 500 Hz, is dedicated to provide CP-R services relating to I/O timeouts, fob 
accounting, and background-exeeution-time limit. 

CP-R requires that two hardware interrupt levels be dedicated to each CP-R dispatcher. 



HUM STORAGE (MEMORY) REQUIREMENTS 

MEMORY SPACE REQUIREMENTS FOR CP-R 

The minimum CP-R configuration which would include 
keyboard/printer, magnetic tape, and disk I/O routines 
only, and provide a minimum number of disk device-files and 
operational labels, requires about 12,OO0jq cells for the 
monitor and its tables. This minimum memory space re- 
quirement would increase as handlers are odded for addi- 
tional peripherals, as optional software routines are chosen 
during SYSGEN, and as additional files, operational labels, 
or user tasks are allocated during SYSGEN. The residence- 
space requirements for CP-R will vary from 12,000 to 
22,000 cells, depending upon the user's configuration. 
If background processing is desired, the user must al low an 
additional minimum of 9,000 cells for background space 
in order to accommodate the CP-R Job Control Processor, 
the standard CP-R subsystems, and the Assembly Program 
(AP). See the "System Generation" chapter for infor- 
mation on the space requirements of the various monitor 
options. 



MEMORY SPACE REQUIREMENTS FOR CP-R PROCESSORS 

The memory space required for concurrent background pro- 
cessing is a function of the longest overlay path of the set 
of processors in question, plus the maximum work-space 
and blocking-buffer requirement of that set. The standard 
CP-R language processors (FORTRAN IV and AP) require 
resident work space for symbol-description rabies during 
compilation or assembly. Thus, the number of source state- 
ments that can be processed in a single compilation or as- 
sembly is directly proportional to the amount of background 
memory available over and above the longest-overlay-path 
requirement. 

All of the CP-R processors are designed to utilize memory 
efficiently and will toke advantage of any excess space that 
may be available. 

Table 36 shows the various combinations of processors that 
are operable in the context of several sample CP-R/memory 
configurations. 



Table 36. Processor Availability in Sample Configuration 





Total Memory in System 


Configuration 


32K 


48K 


64K 


12K CP-R plus 8K resident 
(primary) foreground, no 
secondary foreground, no 
PUBL1B. 

12K CP-R, IK resident 
(primary) foreground, 
16K secondary foreground, 
no primary PUBLIB. 


9K BKGND 

All CP-R Processors except 
FORTRAN IV and SL-1 

16K BKGND* 

All Processors 


17K BKGND 

All Processors (AP assembly 
of about 10,000 lines) 

24K BKGND* or 
8K BKGND* 

All Processors 


25K BKGND 
All Processors 

32K BKGND 1 or 
16K BKG*tD ft 

All Processors 


Only when secondary foreground is inactive and rolled out. 
1 Concurrent with secondary foreground (real-time). 
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MEMORY SPACE REQUIREMENTS FOR 
VSER-fOREGROURD PROGRAMS 

The amount of memory required for user's primary foreground 
programs is the total size requirements for all concurrently 
resident primary programs and their blocking buffers, plus 
the size of the nonresident foreground area if arty. 



The overhead for centrally-connected primary tasks Is 
26 words per interruptible task, for the task control block 
and the task's PSD, plus temp space as follows: 



Monitor Services 
Requirements 

None 



All 



services 



Amount of System Temp Stack 
Required 



150 



More detailed information is given under "Overlay Loader" 
and "System Generation". 



The user temp stack size is dependent upon the routines used. 
See the FORTRAN IV reference manual for, library sizes. 

Blocking buffers are required for each operational label (or 
FORTRAN device number) that is associated with a blocked 
disk file. The blocking buffer size is always 256 words. 

SECONDARY STORAGE REQUIREMENTS 

The optimal type of secondary storage for a CP-R system is 
dependent upon the requirements of the installation. The 
storage capacity required may dictate the use of disk packs, 
or perhaps where access time is very important and the 
majority of transfers ore small, a fixed-head disk would be 
appropriate. (Note that for small average-transfer sizes on 
the order of 500-1000 bytes, access time is more critical 
than transfer rate. ) 

CP-R requires one magnetic rape unit, which also provides 
an optimum backup capability for CP-R and disk pocks. 
Table 37 gives a comparison of the access time, capacity, 
and other pertinent characteristics of the various secondary 
storage devices supported by CP-R on Sigma 9 hardware. 







Table 37. Comparison of Secondary Storage Devices 






Device or 
Device/Control ler 
Combination 


Capacity 

(in megabytes) 


Average 
Access Time 
(in milliseconds) 


Maximum 
Transfer Rate 
(in kilobytes) 


2 
MIOPBandwidth Requirements 


Sigmo 9 
MIOP 


Add if thru 
a 7720 


7202 




.75 mb 


16.9 ms 


187.5 kb 


37% 


7% 


7203 




1.5 mb 


16.9 ms 


187.5 kb 


37% 


7% 


7204 




3.0 mb 


16.9 ms 


187.5 kb 


37% 


7% 


7212 




5.3 mb 


16.9 ms 


3000. Okb 


NA M 


NA 


7232/7231 




6.3 mb 


16.9 ms 


384 kb 


77% 


16% 


7232/7236 3 




6.3 mb 


16.9ms 


384 kb 


34% 


5% 


7246 4 




24.5 mb 


87.5 ms 


312 kb 


50% - 29% 


13% - 3% 


7251 5 




2.3 mb 


50.5 ms 


312 kb 


50% - 29% 


13% - 3% 


7260 




45 mb 


42.5 ms 


512 kb 


51% -39% 


4% - 5% 


7270 




49 mb 


47.5 ms 


312.5 kb 


50% - 29% 


13% - 3% 


7275 




86 mb 


42.5 ms 


806 kb 


77% - 65% 6 


7% 


7315/16 




23mb@800bpi 7 


5 ms 


60 kb 


14% 


3% 


7332 




46mb@1600bpi 7 


5 ms 


120 kb 


22% - 13% 


6%- 1% 


7333 8 




46mb@1600bp? 7 


3.25 ms 


240 kb 


25% 


2% 


7362 




16mb@556bpi 7 


10 ms 


20 kb 


9% 


1% 


7372 




23mb@800bpi 7 ' 9 


5 ms 


60 kb 10 


13% 


3% 


Notes: 1. 


CP-R n 


squires approximately .5 megabytes for system storage, includii 


ig standard processors. 


2. 


CP-Rd 
data ov 
the fou 


oes not manage bandwidth control, thus the installation must bi 
err urn. When two figures are shown, the second figure indical 
r-byte interface is included; this figure is not shown if not app 


s properly configured to avoid 
fes bandwidth requirements when 
icable. The user con combine 
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Table 37. Comparison of Secondary Storage Device* (cont. ) 



Notes: several devices on a logical channel (using the CHAN command at SYSGEN) even though they are on 

(cont. ) separate physical channels. 

3. CP-R requires the 7236 control ler if the extended-width interface is desired. The 7231/7235 combi- 
nation may not be used. 

4. CP-R treats each 7242 as two 7246 disk packs. All disk pocks except the system-residence pack may 
be declared to be removable. 

5. CP-R treats each 7251 as a 720x type device. Each 7252 is treated as two 7251 devices. The remov- 
ability feature of the 7251/52 is not managed by CP-R. A restricted form of removability for 725x 
cartridges is available (see "Removable-Disk Devices"). There is no support for flawed tracks under 
CP-R for this device, unlike for other disk devices. 

6. The 7275 uses the burst-mode feature of the Sigma 9 MI OP, which is included with all systems con- 
figured for Model 7275. The second figure reflects the bandwidth requirement when using burst mode. 

7. Assuming 2400-foot reels and no inrerrecord gaps. Reduce this figure by the percentage of the tape 
required for interrecord gaps. This value is a function of record size since gap is fixed (0.75 inches 
for 7362/72; 0.5 to 0. 75 inches (overoge 0. 6 inches) for 7315/16). 

6. Model 7333: only with extended-width interface (1039). 

9. Model 7372 transfers six bits of information per byte. 

10. Model 7372: reduce transfer rate by 25 percent for packed binary mode. 

11. Requires Sigma Selector IOP (SIOP) with Model 7211 controller. 



The amount of secondary storage required for a CP-R system 
is a function of the secondary storage requirements of CP-R 
itself, plus user requirements for program and data storage, 
plus background temporary file space. 

IT AREA STORAGE REQUIREMENTS 

If a user wants to allocate enough Background Temp area 
to assemble an average 5000-line source program, approxi- 
mately 200 kilobytes of disk storage would be needed. (The 
smallest Xerox disk unit, Model 7202, has a . 75 megabyte 
storage capacity. 



total number of areas in the system may not exceed 21. ) An 
area can be up to 32 mb in size. 

Also, part or all of a pack can be used as a direct (random) 
file with no area limitations, by means of a device-access 
type of assignment. 

7244 PACK COPY 

The RAD EDIT command DPCOPY may be used to create a 
backup copy of a pack on another pack. The user must first 
assign a DCB to each device, with a device-type assignment, 
and then execute RADEDIT. 



USER SECONDARY STORAGE REQUIREMENTS 

Figure 34 illustrates the hierarchy of CP-R file manage- 
ment. It is important to note that since a file may not span 
physical device boundaries, the capacity of secondary 
storage devices at an installation may limit the maximum 
file size. Furthermore, the maximum size of any file or 
area is 32 megabytes, independent of device capacity. 



7251/52 DISK AREA DEFINITION 

All areas for the removable 7254 disk cartridges (for 
Model 7251 or 7252 Cartridge Disk Systems) must be en- 
tirely defined at system generation time (SYSGEN). Any 
cartridge mounted on a given spindle will automatically 
assume the attributes of that spindle as defined at SYSGEN. 
If areas must be redefined, a complete 'ALL'^VSGEN must 
be performed. 



REMOVABLE DISK PACKS AND CARTRIDGES 

DISK AREA DEFINITION AND PACK INITIALIZATION 

Each disk drive provides from 24 to 86 megabytes of stor- 
age, which can be divided into from 1 to 21 areas. (The 



7254 CARTRIDGE INITIALIZATION 

SYSGEN will automatically initialize the first and second 
sector of each area defined on any cartridges mounted at 
SYSGEN. When interchangeable cartridges are to be 
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The following rules apply: 



• A physical device (e.g., DISK) may contain several areas. An area is totally contained on one physical 
device . 

• An area may contain one or more files. A file i$ totally contained within one area. 



Figure 34. CP-R Disk File Management 



initialized subsequent to SYSGEN, they must be mounted 
on the appropriate spindle and a RAD EDIT CLEAR com- 
mand given for each area associated with that spindle. This 
must be done prior to using a RADEDIT MAP or ADD com- 
mand. Files subsequently defined will be available when- 
ever that cartridge is mounted. 



7254 CARTRIDGE MOUNTING 

Any cartridge mounted on a spindle automatically assumes 
the area definitions defined at SYSGEN for that spindle; 
therefore, interchangeable cartridges may only be mounted 
on a spindle compatible with that cartridge. The cartridges 
are compatible only when they have been initialized with 
the exact area allocations as were defined at SYSGEN for 
that spindle. Cartridges must be initialized, as described 
previously, prior to use. 



7254 CARTRIDGE REMOVAL 

Cartridges may not be removed until all files contained on 
that cartridge are closed and the device-file numbers ore 
released. Cartridges used exclusively by background should 
only be removed or replaced between sequences of jobs, i.e., 
following a FIN command and preceding a JOB command. 
Cartridges used by foreground tasks con be safely removed 
only on the basis of a thorough understanding of the fore- 
ground application. It is recommended that the foreground 
tasks communicate to the operator when tfll file activity has 
ceased (files closed and device-file numbers released). 

Special precaution must be taken for 7252 Cartridge Disk 
units. Since the fixed disk as well as the removable disk is 
Stopped when replacing the cartridge, all file activity must 
be quiesced for both the fixed and removable portions of 
the device (which are independently addressable). If the 
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SP area resides on the fixed disk, the computer must be 
placed in a completely idle state (no active background 
or foreground, no key-ins pending). Failure to do so will 
result in an ALAIM when an attempt is made by CP-R to 
access an overlay. Foreground tasks that access files on 
the fixed portion of a 7252 drive may also require the com- 
puter to be in the idle state to ovoid the 'non-operational' 
condition. Obviously a critical real-time environment can- 
not tolerate the computer being in 'idle', therefore, proper 
allocation of areas and spindles is essential (e.g., two 7251 
devices may be required rather than a single 7252). 



7254 CARTRIDGE COPIES 

In order for 7254 back-up cartridges to be created, two 
'removable' spindles should be available with identical 
area-size definitions but with different area-name assign- 
ments. As indicated previously, the cartridge to be copied 
to must have been previously initialized. RADEDIT may 
then be used to provide an area-to-area copy. 

If an installation has only two spindles with one being the 
system-residence device (i.e. , 'nonremovable') and desires 
to create backup cartridges, the cartridges to be copied 
must themselves contain a copy of CP-R. The cost of this 
is approximately 10 percent of the cartridge capacity. Al- 
though it is possible to perform a cartridge copy on a single 
7252 unit (i.e., a copy of the fixed-disk portion to the 
cartridge), the procedure would be cumbersome and error 
prone. It is therefore recommended that two 7251s be 
utilized instead of a single 7252. (Multiple 7252s or a com- 
bination of 7252 and 7251 are equivalent to multiple 7251s 
in this respect, of course, ignoring the cost factor. ) 



PERIPHERAL EQUIPMENT REQUIREMENTS AND OPTIONS 

KEYBOARD/PRINTER- REQUIRED 

CP-R requires that the minimum configuration include a 
keyboard/printer for operator control. This must always 



be located on MIOP 0, device address 01. (All other 
device addresses are determined at SYSGEN time.) 



CHARACTER-ORIENTED COMMUNICATIONS (COC) - 
OPTIONAL 

e One buffered input/output channel dedicated to a 
7630 Controller, with eight lines. 

• External DIO interface feature. 

• Two external interrupts dedicated to the COC controller. 

The COC software support requires approximately 2K words 
of resident memory space, including some line-buffer space. 

ADDITIONAL PERIPHERAL OPTIONS 

Consult the "System Generation" chapter for information 
about other optional peripheral devices supported by CP-R. 



MISCEUANEOUS HARDWARE OPTIONS 

REGISTER BLOCKS 

Additional register blocks can be used by primary real-time 
tasks to reduce context-switching time on task entry and 
exit. If terminal job entry is selected, register block one 
is required. 

POWER ON/OFF 

Although this feature is standard in Sigma 9 hardware, CP-R 
software does not provide a generalized support for it, since 
recovery sequences are so application-dependent in a real- 
time system. Users interested in a power fail-safe capability 
can handle these interrupts by means of a primary task that 
provides for the installation's specific requirements in this 
regard. 
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APPENDIX A. SYSTEM CP-R 



System CP-R is written for use under the AP (level A01 or 
greoter) assembler. 



SYSTEM CP-R PROCEDURE REFERENCES 

For any CAL that requires a Function Parameter Table (FPT), 
System CP-R provides a procedure that can generate four 
different CAL and FPT combinations. The combination is 
chosen by a keyword in the procedure CF(2) field. 



CAL ONLY FORM 

j 
The lost form generates only the CAL, at the position of the 
procedure reference. Ft has the form 

LABEL 1, ...LABELn M.-CAL.CAL oddress 

The keyword "CAL" specifies this form of the procedure. 
The labels are all defined as the oddress of the CAL. The 
"oddress" field is the word address of an FPT, optionally 
with indexing or indirection. 



DEFAULT FORM 

The default format is used when the CF(2) field of the pro- 
cedure is absent. It has the form 

LABEL 1,LABEL2 M£AL parameters 

In this form, the CAL instruction is generated at the posi- 
tion of the procedure reference. The FPT is generated in 
the next available space of a separate CSECT, which is al- 
located by the first use of a procedure of this form. The 
parameters define the size and content of the FPT. LABEL 1, 
if it exists, is defined as the address of the CAL. LABEL2, 
if it exists, is defined as the address of the first word of the 
FPT. Further labels are ignored. 



INLINE FPT FORM 

Another form is provided to avoid generating a separate 
CSECT. It is similar to the default form, but generates the 
FPT preceded by a branch instruction following the CAL. 
The branch address is the first word after the FPT. It has 
the form 

LABEL1,LABEL2 M:CAL, 1NLN parameters 

The keyword "INLN" in the CF(2) field specifies the in-line 
FPT form of the procedure. The labels and parameters are 
used in the same way as for the default form. 



FPT ONLY FORM 

This form generates only the FPT, at the position of the pro- 
cedure reference (with no branch instruction preceding the 
FPT). It has the form 

LABEL 1,..., LABELn M:CAL, FPT parameters 

The keyword "FPT" specifies this form of the procedure. 
The parameters are treated as in the default form, but all 
labels are defined as the first word address of the FPT. 



PARAMETER FIELD 

In the first three procedure forms above, the argument field 
is a list of parameters defining an FPT. With a few excep- 
tions, each parameter in the list is a parenthesized group 
consisting of a keyword, possibly followed by a value. Cer- 
tain keywords ("flags") indicate only a single bit of infor- 
mation by their presence or absence. If a value follows one 
of these flags, it is considered an extra value. Other 
keywords normally are followed by a value. If the value 
is omitted, zero is assumed. 

If a parameter group specifies a value for an FPT field, a 
label may be defined as the address of the word containing 
the field. This is done by including the label as the third 
item in the parameter group. For example, 

M:INIT (TASK, 'ABCD', HERE) 

Defines the label 'HERE' as the address of the task name 
field in the INIT FPT. Flag parameters which signify the 
inclusion of a full word (i.e., 'TYC or 'TYPE2') may label 
that word by including the label as the second item in the 
parameter group. 

Two prominent exceptions to the "(keyword, value)" format 
for parameters are the DC B address for the I/O CALs and the 
file identification for several other CALs. The former is a 
single unkeyed value, which must be first in the parameter 
list (this provides compatibility with System BPM). The 
latter is the keyword "FILE" followed by either one or two 
text values. If two values follow, they are assumed to be 
the area name and the file name, in that order. V only one 
value follows, it is assumed to be the file name. In either 
case, a label may follow the last parameter. It will take 
the address of the file name field as its voW. 



In any case where a parameter is a single item rather than 
a group of items, the parentheses may be omitted. 

If an FPT word is optional, it is generated only if a param- 
eter is referenced which affects that word. The parameter 
presence bits are set accordingly. 
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SYSTEM CMI ERRORS 

Generally, the procedure system generates as much as it can 
determine from the procedure reference, notifying the user 
with error messages that certain information was unusable. 



*uch a group, any parameter will be accepted for any CAL, 
even though the parameter might be meaningless or illegal 
for that CAL. It is the user's responsibility to know which 
parameters are necessary for the CALs used. 



Extra items in a parameter group are unused. K a value 
item is in error, a zero value is used. If a keyword is in 
error, the parameter group which it heads is ignored (which 
may cause an FPT optional word to be omitted). 



CAL PARAMETER GROUPS 

The system CP-R CAL procedures each translate a set of 
parameters for a group of CALs with similar FPTs. Within 



SPECIFIC CAL-PARAMETER GROUPS 

Listed below in Figure A-1 are the CALs in the groups for 
each procedure in system CP-R, followed by the parameters 
processed by that procedure. 
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ABN 
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BLOCK 
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EUF, BUFFER 
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CKWRT 

DCP 

DIAG 

EAADDR 

EACSA 

EAINTLB 

EAINTNF 

ERR, ERROR 

FPT 

FUNC 

FWD 

IGNERR 

10012 

LWAIT 



KEANIHG AND SAMPLE 



DCB ADDRESS (REQUIRED TO BE FIRST) 

M:FEAD DCE 

ABfJORVAL RETURN ADDRESS (MAY EE INDIRECT) 

K:READ DCB, (ABN.XXXX) OR (ARN.'XXXX) 

BLOCKING BUFFER ADDRFSS FOR OPENING FILE 

(MAY FE INDIRECT) 

KrFEAD DCF , (PEA ,XXXX) OR 

GRANULE NR FOR DIRECT FFAD, 

M:PEAD DC?, (BLOCK, N) OR (BLOCK ,«XXXX) 

BYTE IN WORD TO START, OR ADDRESS OF SAME 

M:PFAD DC3,(PTD,N) OR 

BUFFFR ADDRESS (MAY BE 



(BBA,»XXXX) 

OR ADDRESS OF SAME 



(ETD,«XXXX) 

INDIRECT) 

OP (BUF,«XXXX) 



MtPEAD DCB,(PUF,XXXX) 

BUSY RETURN ADDRESS 

M:READ DCE, (BUSY, TXXX) 

WRITE WITH CHFCKREAD TO DISK 

M:V.'PITF DCB, (CKWRT) 

INDICATF.S DCS BEING CHECKED 

MrCHECK DCB, (DCP) 

OPERATION WILL BE VALID ONLY IF DEVICE 

IS IN DIAGNOSTIC MODE 

M:FEAD DCB.DIAG 

END ACTION ADDRESS 

M:READ DCB, (EAADDP.XXXX) 

END ACTION COMPLETION STATUS ADDRESS 

M:P£AD DCE,(FACSA,XXXX) 

FND ACTION INTERRUPT LABEL 

M-.FF.AD DCB,(FAINTLB,'I3') 

FND ACTION INTERRUPT NUMBER 

M:READ DCB, (FAINTNR,X'65' ) 

ERROR RETURN ADDRESS (MAY BE INDIRECT) 

M:READ DCB, (ERR ,XXXX) OR (ERR,*XXXX) 

INDICATES FPT P-FINC CHECKED 

M:CHECK DCB, (FPT) 

FUNCTION CODE FOR SPECIAL DEVICE HANDLER, 

OR ADDRESS OF SA»'E 

MrRFAD DCB, (FUNC, X' 12' ) OP (FUNC,«XXXX) 

READ OF SPACE FORWARD 

M:PFAD DCB, (FWD) 

IGNORE ERRORS (ABORT OVERRIDE) 

M:READ DCB, (IGNERR) 

DATA TO BE PASSED TO SPECIAL DFVICE HANDLER 

IN 10012 TABLE, OR ADDRESS OF SAME 

M:READ DCB, (I00I2.X » 123*** ) OR (IOC I2,»XXXX) 

LONG WAIT INDICATOR (PRIME ROLLOUT CANDIDATE) 

K-.READ DCB, (LWAIT) 



Figure A-l. Specific CAL-Parameter Groups (cont. ) 
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CROUP 1: 
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NUMBER OF UNITS TO SKIP OR ADDRESS CONTAINING SAME 

K:PPEC DCP,(N,2S) OP (N,»XXXX) 

NO CHECK ON OPFRATION (DELETE ON POST) 

M:FFAD DCB,(NOCfC) 

PROrPT CHAPACT^P TO BE WRITTEN 3EFORE A READ FRON" 

A KEYBOARD-PRINTER DEVICF, OR ADDRESS OF SA M E 

MrPEAD DCB, (PROMPT, '-') OR ( PROMPT, »ADDR ) 

PAPER TAPE PEAD IMMEDIATE 

MrPFAD DCB,(PTRI) 

PAPER TAPE PEAD DIRECT 

H:READ DCP,(PTRD) 

READ OR SPACE REVERSE 

M:READ DCB.(REV) 

PYTE LENGTH OF TRANSFER, 

M:READ DC? , ( PECL , N ) OR 



OR ADDFESS OF 
(RECL,*XXXX> 



SAME 



SPACF PAST EOF ON SKIP OPFRATION 

M:PREC OCB,{SKIP) 

TIMEOUT COUNTER 

M:READ DCP, (TIME, 10) 

INDICATES 7YPF I I/O 

M:READ DCB, (TYPED 

WAIT FOR COMPI.FTIOM OF OPERATION BEFORE RETURN 

M:READ DCB, (WAIT) 

INDICATES TYPE II I/O, FORCES PRESENCE OF POST WORD 

M:READ DCP,(TYPF?) 



• • t *»•»••*•••••* GROUP 2 



» • « • • 



»*••»#«•• 



NAME 



CAL 



r- 



M:ABORT 


CAL1 
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X'03* 


M:EXDA 


CAL1 


,9 


X'OA' 


M:FXIT 


CALI 


,9 
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M:TERM 


CALI 
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M:TRTN 
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X'05' 


MrWAIT 


CALI 


,9 


X'09' 


M:XXX 


CALI 


,9 


X'03* 


THE ABOVE 


CALS 


HAVE NO PARAMETERS 



• ••*!•••••••#•*» GROUP 3»»««»«»»»«»»»»»« 

NAME CAL FPT CODE 

M:INT CALI, 8 X ' OE ' 
M:PC CALI,) X'2C' 
MrTIME CALI, 8 X 1 10' 

THESE CALS EACH HAVE A SINGLE UNKEYED PARAMETER: 
THE TIME RETURN BLOCK ADDRESS FOR M:TIME, 
THE BREAK PROCESSOR ADDRESS FOR M:INT, 
AND THE NEW PPOMPT CHARACTER FOR M:PC 
MrTIME XXXX 



Figure A-l. Specific CAL-Parometer Groups (conr. ) 



276 Appendix A 



NAME 



GROUP ft 
CAL 



FPT CODE 



M.-CALFTN CAL 1,7 X'60' 
K:MASTER CAL 1,8 X'OS* 
M: SLAVE CAH.B X'07* 

THE ABOVE CALS HAVE NO PARAMETERS 



>•««*« GROUP 5 « • • t • i 
NAKF CAL FPT COPE 
M:GETTIME CALI.7 X'rM' 



KEYWORD 

stimf 

UTIME 



MEANING AND SAMPLE 

RETURN SYSTE'' CLOCr VALUE (SECOJJDS SINCF **IDNIGHT) 
r:f , ffTTIt . r (TI v F) 

RETURN USER CLOCr VALUE (SECONDS SINCE SYSTEM BOOT) 
M:GETTIME (UTIME) 



NAME 



GROUP 6 • • • • • 
CAL FPT CODE 



M:PRINT CALI.2 X'OP 
M:TYPE CAL1.2 X'02 1 



KEYWORD 
MESS 

TIME 
WAIT 



MEANING AND SAMPLE 

ADDRESS OF THE MESSAGE IN TEXTC FORMAT (MAY BE 

INDIRECT) 

M:PRINT (MESS.XXXX) OR (MESS,»XXXX) 

TIMEOUT COUNTER 

M:TYPE (TIME, 20) 

WAIT FOR COMPLETION BEFORE RETURNING 

M.-PRINT (WAIT) 



i t * • t GROUP 7 • • • ■ • " 
NAME CAL FPT CODE 
MrCORRES CALI.l X'2B* 



KEYWORD 
DCB1 

DCB2, 



MEANING AND SAMPLE 



THE ADDRESSES OF THE DCBS TO COMPARE (MAY BE INDIRECT) 
M:CORRES (DCB1.XXXX) OR (DCBI,»XXXX) * 



Figure A-l. Specific CAL -Parameter Groups (cont.) 
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NAPE CAL FPT CODE 




M:PLS CALI.5 X'OB' 




M:RUN CALI.5 X'OC 


KEYWOPD 


MEANING AND SAMPLE 


FILEN 


FILE NAME FROM WHICH TO LOAD. 




M:RUN (FILEN, 'HORSE') 


INTLB 


INTERRUPT LABEL TO TRIGGER ON COMPLETION 




M:RUN (INTLB, '13') 


INTNP 


INTERRUPT NUMBER TO TRIGGER ON COMPLETION 




M:RUN (INTNR,X'65') 


ISP 


SUPPRESS STORAGE OF COMPLETION CODE 




M:RUN (ISP) 


PRIO 


PRIORITY AT WHICH TO OUEUE THE RUN 




M:RUN (PRIO.X'SOOO') 


SIC 


ADDRESS TO STORE COMPLETION CODE 




M:PUN (SIG.XXXX) 




NAME CAL FPT CODE 




M:JTRAP CALI,7 X'5D» 




M:TRAP CAL 1,8 X'14' 


KEYWORD 


MEANING AND SAMPLE 


(NO KEYWORD) 


TRAP RECEIVER ADDRESS (IF INCLUDED, MUST BE FIRST. IF 




OMITTED, FIRST PARAMETER MUST NOT BE A SINGLE ITEM> 




M.-TRAP XXXX 


ABORT 


THE TRAPS INDICATED BY THE FOLLOWING CODES 




WILL CAUSE TASK ABORT 




MtTRAP (ABORT, AA.BB.CC.DD) 


IGNORE 


RESET THE PERMIT BIT IN THE PSD FOR THE 




TRAPS INDICATED BY THE FOLLOWING CODES 




M:TRAP (IGNORE, AA.BB) 


PERMIT 


SET THE PERMIT BIT IN THE PSD FOR THE 




TRAPS INDICATED BY THE FOLLOWING CODES 




MSTRAP (PERMIT, AA,BB) 


TRAP 


THE TRAPS INDICATED BY THE FOLLOWING CODES 




WILL CAUSE TRANSFER TO THE TRAP RECEIVER 




M:TRAP XXXX, (TRAP, AA,BB,CC,DD) 


CAL 


CODE FOR THE CAL ERROR SIMULATED TRAP 


DEC 


CODE FOR THE DECIMAL ARITHMETIC ERROR TRAP 


FP 


CODE FOR THE FLOATING ARITHMETIC ERROR TRAP 


FX 


CODE FOR THE FIXED ARITHMETIC ERROR TRAP 


NAO 


CODE FOR THE NON-ALLOWED OPERATION TRAP 


PS 


CODE FOR THE STACK LIMIT TRAP 


01 


CODE FOR THE UNIMPLEMENTED INSTRUCTION TRAP 


WDG 


CODE FOR THE WATCHDOG TIMER TRAP "* 




M:TRAP HANDLER, ( ABORT, WDG, CAL, PS, FP.FX),; 

(TRAP, NAO, UI), (PERMIT, FX), (IGNORE, DEC) 





Figure A-l. Specific CAL-Parometer Groups (cont. ) 
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NAME 



GROUP 10 • • • • * 
CAL FPT CODE 



M:DISABLE CALI, 5 X'OP 
M:ENABLE CALI, 5 X'02 1 
M:TRIGGER CAL 1, 5 X'OO' 



KEYWORD MEANING AND SAMPLE 

(WITH ALTERNATES) 



ERR, ERROR 

INTLB 

INTNR 



ADDRESS FOR ERROR RETURN 

K-.TRIGGER (ERR f XXXX) 

LABEL OF THE INTERRUPT TO AFFECT 

MrTRIGGER (INTLB, »I3') 

ADDRESS OF THE INTERRUPT TO AFFFCT 

M:TRIGGER (INTNR, X'70') 



GROUP I 1 



NAME 

M:ACT 

M:ALARM 

M: ALLOT 

HrDEACT 

MrDEBUG 

M:DELETE 

M:DEO 

M:ENO 

M:ERASE 

M-.EXTM 

M:CETPAGE 

KrINIT 

KrKJOB 

M CLOCK 

MrMODIFY 

M:POLL 

M-.POST 

M:RECALM 

MrRELPAGE 

H:SCHED 

M:SETNAME 

MrSIGNAL 

M:SJOB 

H:START 

M:STATUS 

M:STIMER 

MrSTOP 

MrTEST 

M:TEXIT 

*:TRTY 

K'.TRUNC 

M:UNLOCK 

MrWAITALL 

M-.WAITANY 



CAL 



FPT CODE 



CALI, 


7 


X«52' 


CAL1 


7 


X'6A« 


CALI 


7 


X'5A' 


CALI 


7 


X'53* 


CAL! 


7 


X'65' 


CALI 


7 


X'5B' 


CALI 


7 


X'HD' 


CALI 


7 


X'lC 


CALI 


7 


X'54' 


CALI 


7 


X'49' 


CALI 


,7 


X'57« 


CALI 


7 


X'UB' 


CALI 


7 


X'6U» 


CALI 


7 


X'55« 


CALI 


7 


X'UF* 


CALI 


7 


X'45' 


CALI 


,7 


X'»l6' 


CALI 


,7 


X'69' 


CALI 


7 


X'58' 


CALI 


,7 


X«68' 


CALI 


,7 


X'5P 


CALI 


7 


X'H3' 


CALI 


7 


X'63' 


CALI 


,7 


X'iJA' 


CALI 


,7 


X'4E' 


CALI 


,7 


X'tl* 


CALI 


,7 


X'UE' 


CALI 


,7 


X'42' 


CALI 


7 


X'5F' 


CALI 


,7 


X'SE' 


CALI 


,7 


X'5C 


CALI 


7 


X'56« 


CALI 


,7 


X'HO« 


CALI 


,7 


X'HI' 
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GROUP 1 t : 


(CONTINUED) 




KEYWORD 


MEANING AND SAMPLE 




(WITH ALTERNATES) 




ABORT 


ABNORMAL EXTM INDICATOR 
M:EXTM (ABORT) 




ACNTPTF 


ADDRESS OF 2-WORD BLOCK CANTAINING A 
FILE ACCOUNT NAME. MAY BE INDIRECT. 
M:ALLOT (ACNTPTR,XXXX) OR (ACNTPTR.'XXXX) 




ALADR 


ALARM RECEIVER ADDRESS (MAY BE INDIRECT) 
M.-ALMPEC (ALADR, DOWNER) OR (ALADR, •K:CRSH) 




ALMSG 


ADDRESS OF MESSAGE FOR ALARM CAL 

(MAY BE INDIRECT) 

MtALARM (ALMSG, MESS) OR (ALMSG, «ADDR) 




AREA 


FILE UREA NAME 
H:INIT (AREA.'FP*) 




CLASS 


ASYNCHRONOUS EVENT CONTROL CLASS MASK 
M.-SIGNAL (CLASS, X'FFFF') 




DEBUG 


INITIATE TASK UNDER CONTROL OF THE CP-R DEBUGGER 
M:INIT (DEBUG) 




DEL 


DELETE THE TASK FROM THE SCHEDULING LIST 
M:SCHED (DEL) 




EAADDR 


END ACTION TRANSFER ADDRESS 
M:INIT (F.AADDR.XXXX) 




EACSA 


END ACTION COMPLETION STATUS ADDRESS 
M:INIT (EACSA, XXXX) 




EAINTLB 


END ACTION INTERRUPT LABEL 
M:INIT (EAINTLB, '13') 




EAINTNR 


END ACTION INTERRUPT NUMBER 
M:INIT (EAINTNR, X'65') 




ERR, ERROR 


ERROR RETURN ADDRESS (MAY BE INDIRECT) 
M:INIT (ERR, XXXX) OR (ERR,«XXXX) 




EXCL 


ENOUEUE FOR EXCLUSIVE ACQUISITION 
M.-ENQ (EXCL) 




FILE 


FILE NAME, OR FILE AND AREA NAMES 
MrALLOT (FILE, 'BP' , 'TEST* ) OR 
M: ALLOT (FILE, 'TEST' ), (AREA, 'BP' ) 




FSI 


FILE SIZE IN RECORDS (OR ADDRESS OF SAME) 
M:ALLOT (FSI, 20) OR (FSI,»XXX) 




GO 


INIT WITH START 
M:INIT (GO) 




GSI 


GRANULE SIZE IN WORDS (OR ADDRESS OF SAME) 
M: ALLOT (GSI, 128) OR (GSI,»XXX) 




IGNERR 


IGNORE ERRORS (ABORT OVERRIDE) 
H: START (IGNERR) 




IMMED 


ENQUEUE FOR IMMEDIATE ACQUISITION 
M:ENQ (IMMED) 




INTV 


INTERVAL TIME FOR SCHED SERVICE 
M:SCHED (INTV.50) 




IHTVL 


STIMER VALUE IS AN INTERVAL 
MrSTIMER (INTVL) 




JOB 


JOB NAME 

MrSIGNAL (J0B, , J0B2 I ) 




JOBL 


JOB LEVEL ENQUEUE 
M:ENQ (JOBL) 




LWAIT 


LONG WAIT INDICATOR 
MrGETPAGE (LWAIT) 




NOCK 


NO CHECK REQUIRED ON CAL WITHOUT WAIT (DELETE ON POST) 




ORG, FOR 


FILE ORGANIZATION (OR ADDRESS OF SAME): U (UNBLOCKED), 






B (BLOCKED), OR C (COMPRESSED) 


« 




M: ALLOT (FOR.B) OR (FOR, "XXX) 




PRI 


INIT A PRIMARY TASK 
M:INIT (PRI) 




PRIO 


PRIORITY AT WHICH DISPATCH IS TO BE DONE 

(OR ADDRESS OF SAME) 

M:INIT (PRIO,X'FFFF«) OR (PRIO,»XXXX) 
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GROUP 1 1 : 


(CONTINUED) 


RDATA 


ASYNCHRONOUS EVENT CONTROL RECEIVED DATA SIZE 




AND ADDRESS 




M:POLL (RDATA.I6.XXXX) 


REBOOT 


REINITIALIZE SYSTEM AFTER ALARM PROCESSING 




M:RECALK REBOOT 


RESFGD 


ALLOT A RESIDENT FGD PROGRAM FILE 




M:ALLOT (RESFGD) 


RNAME 


RESOURCE NAME 




M.-ENO (RNAME.'THING') 


PSI 


RECORD SIZF IN WORDS (OR ADDRESS OF SAME) 




M:ALLOT (RSI, 20) OR (RSI,»XXX) 


SDATA 


ASYNCHRONOUS EVENT CONTROL SIGNAL DATA ADDRESS 




M:SIGNAL (SDATA f XXXX) 


SEC 


INIT A SECONDARY TASK 




M:INIT (SEC) 


SEC 


SEGMENT NUMBER FOR MEMORY MANAGEMENT CALS 




M:ACT (SEC, 1) 


SHARE 


ENQUEUE FOR SHARED ACQUISITION 




M:ENO (SHARE) 


STOP 


INIT WITHOUT START INDICATOR 




M:INIT (STOP) 


STRTPTR 


ADDRESS OF 2-WORD BLOCK CONTAINING A 




SCHED SERVICE START TIME. MAY BE INDIRECT. 




M:SCHED (STRTPTR ,XXXX) OR ( STRTPTR, »XXXX) 


SYSL 


SYSTEM LEVEL ENOUEUE 




M-.ENQ (SYSL) 


TASK 


TASK NAME 




M:INIT (TASK.'FSEG*) 


THRESH 


STIMER VALUE IS A THRESHHOLD TIME 




M:STIMER. (THRESH) 


TIME 


TIMEOUT COUNTER 




MrPOLL (TIME, 50) 


TS 


INITIATE TASK FOR TIME-SLICED EXECUTION 




M:INIT (TS) 


TYC 


INCLUDE A COMPLETION POSTING WORD IN THE FPT 




M-.INIT (TYC) 


VPNL 


LOW VIRTUAL PAGE NUMBER (MEMORY MGT) 


VPNH 


HIGH VIRTUAL PAGE NUMBER (MEMORY MGT) 




M:GETPAGE ( VPNL, 32 ), (VPNH, 3 1 *) 


WAIT 


WAIT FOR COMPLETION BEFORE RETURN 




M:INIT (WAIT) 








NAME CAL FPT CODE 




M:ARM CAL1.5 X'Olt' 




M:CON CALI.5 X'Ot' 




M.-DISARM CAL 1,5 X*03' 




M:DISCON CAL1.5 X'03' 


KEYWORD 


MEANING AND SAMPLE 


(WITH ALTERNATES) 


AI 


ADDRESS INCREMENTATION OPTION ON A CAL CONNECTION 




M:CON (AI) "* 


AM 


ENTER CONNECTED ROUTINE WITH FIXED ARITHMETIC MASK SET 


CI 


ENTER CONNECTED ROUTINE WITH CLOCK GROUP INHIBITED 


DE 


INTERRUPT TO BE DISABLED 


DI 


DIRECT CONNECTION 


DM 


ENTER CONNECTED ROUTINE WITH DECIMAL MASK SET 


EI 


ENTER CONNECTED ROUTINE WITH EXTERNAL GROUP INHIBITED 


II 


ENTER CONNECTED ROUTINE WITH I/O GROUP INHIBITED 
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GROUP 12: 


(CONTINUED) 




MS 


ENTER CONNECTED ROUTINE IN SLAVE MODE 
MrCON DE,DI,CI,II,EI,MS,DM,AM 




ERR, ERROR 


ERROR RETURN ADDRESS (MAY BE INDIRECT) 
MrCON (ERR.XXXX) OR (ERR,»XXXX) 




ICNERR 


IGNORE ERRORS (ABORT OVERRIDE) 




INTLB 


INTERRUPT LABEL OF THE INTERRUPT TO AFFECT ' 
M:CON (INTLB, '13') 




INTNR 


INTERRUPT NUMBER OF THE INTERRUPT TO AFFECT 
M:CON (INTNR, X'65') 




JOB 


JOB NAME FOR CONNECTION 
M:CON (JOB.'THATJOB') 




MTW 


MTW INSTRUCTION OR CLOCK VALUE 
M:CON (MTW,X'33FOOOOO«+XXXX) 




NR 


NUMBER OF REGISTERS TO SAVE 
M:CON (NR,8) 




RBLK 


REGISTER BLOCK NUMBER 

M:CON (RBLK.2) / 

START ADDRESS FOR CENTRAL CONNECTION r 




START 






M:CON (START, XXXX) 




TASK 


TASK NAME FOR CONNECTION 
M:CON (TASK.'THISTASK*) 




TCB 


TCB ADDRESS 

M:CON (TCB, XXXX K 




TYC 


COMPLETION WORD TO BE RESERVED IN FPT 
M:CON (TYC) 




XPSD 


XPSD ADDRESS FOR DIRECT CONNECTION 
M:CON (XPSD, XXXX) 






NAME CAL FPT CODE 






M:SEGLOAD CALI.8 X'OI' 




KEYWORD 


MEANING AND SAMPLE 




(WITH ALTERNATES) 




EAADDR 


END ACTION TRANSFER ADDRESS 
MrSEGLOAD (EAADDR, XXXX) 




EACSA 


END ACTION COMPLETION STATUS ADDRESS 
M:SEGLOAD (EACSA, XXXX) 




EAINTLB 


END ACTION INTERRUPT LABEL 
M:SEGLOAD (EAINTLB, »I3» ) 




EAINTNR 


END ACTION INTERRUPT NUMBER 
MrSEGLOAD (EAINTNR, X'65' ) 




ERR, ERROR 


ERROR RETURN ADDRESS 
MrSEGLOAD (ERR.XXXX) 




SEC 


SEGMENT NUMBER TO LOAD 
MrSEGLOAD (SEG.I2) 




T 


TRANSFER TO SEGMENT WHEN IT IS LOADED 






MrSEGLOAD T 
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i ■ • • • CROUP 15 • • • ■ 
NAME CAL FPT CODE 
M:JOB CAL1.7 X'67' 



KEYWORD MEANING AND SAMPLE 

(WITH ALTERNATES) 



DEF 
DEL 

ERR.ERROR 
FILPTR 

IDNP 

IGNERR 

IN 

OUT 
PFIO 

QNR 

SFILPTR 

STAT 

STATCK 

TYC 



INDICATES A SYMBIONT FILE MUST BE DEFINED 

FOR THE INDICATED JOB 

M:JOB (DEF) 

INDICATES THAT ALL SYMBIONT FILES ASSOCIATED WITH 

THE GIVEN JOB ARE TO BE DELETED 

M:JOB (DEL) 

ERROR RETURN ADDRESS (MAY BE INDIRECT) 

M:JOB (ERR, XXX) OR (ERR,«XXX) 

ADDRESS OF DATA AREA CONTAINING NAME OF FILE TO SUBMIT 

FOR BACKGROUND EXECUTION (MAY BE INDIRECT) 

M:JOB (FILPTR, XXX) OR (FILPTR, «XXX) 

THE JOB IDENTIFICATION NUMBER OF THE SYMBIONT 

JOB CONCERNED, OR A POINTER TO SAME. 

M:JOB (IDNR.30) OR (IDNR,«XXX) 

INDICATES THAT ERRORS ARE TO BE IGNORED 

(ABORT OVERRIDE) 

M:JOB (IGNERR) 

INDICATES THAT AN INPUT SYMBIONT FILE MUST BE DEFINED 

M:JOB (IN) 

INDICATES THAT AN OUTPUT SYMBIONT FILE MUST BE DEFINED 

M:JOB (OUT) 

PRIORITY OF THE SYMBIONT JOB CONCERNED, OR 

POINTER TO SAME 

M:JOB (PRI0.5) OR (PRIO,»XXX) 

RETURNED NUMBER OF SYMBIONT JOBS OUEUED 

AHEAD OF THE ONE CONCERNED, OR POINTER TO SAME 

M:JOB (ONR.O) OP (QNR, "XXX) 

ADDRESS OF DATA AREA IN WHICH A SYMBIONT 

FILE NAME WILL BE RETURNED (MAY BE INDIRECT) 

M:JOB (SFILPTR.XXX) OR (SFILPTR, »XXX) 

THE RETURNED STATUS OF THE SYMBIONT JOB 

CONCERNED, OR A POINTER TO SAME. 

M:JOB (STAT.O) OR (STAT,«XXX) 

INDICATES THAT THE CAL IS ONLY TO CHECK THE STATUS 

OF THE SYMBIONT JOB CONCERNED 

M:JOB (STATCK) 

INDICATES THAT A WORD IS TO BE RESERVED IN THE 

FPT FOR RETURNING THE CAL TYPE COMPLETION CODE 

M:JOB (TYC) 
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>*•••• GROUP 16 • • • • • 
NAME CAL FPT CODE 
MrPFEFMOD CAL 1,7 X'50' 



KEYWORD MEANING AND SAMPLE 

(WITH ALTERNATES) 



ERR, ERROR 

IGNERR 

PBA 

REL 

RES 

TYC 



ERROR RETURN ADDRESS (MAY BE INDIRECT) 

K.'PREFMOD (ERR.XXXX) OR (ERR,«XXXX) 

IGNORE ERRORS (ABORT OVERRIDE) 

M:PREFMOD (IGNERR) 

PARTITION BASE ADDRESS 

M:PREFMOD (PBA.XXXX) 

RELEASE PARTITION FROM ITS CURRENT CLASS 

MrPREFMOD (REL) 

RESTORE PARTITION TO ITS FORMER CLASS 

MrPREFMOD (RES) 

COMPLETION STATUS WORD TO BE RESERVED IN FPT 

M:PREFMOD (TYC) 



NAME 

MrASSIGN 
M:GETASN 
MrMEDIA 
MrSTDLB 



GROUP 17 • • • • • 

CAL FPT CODE 

CAL I, I X'08' 

CALt,t X'09' 

CAL 1,7 X'59' 

CAL 1,7 X'62' 



KEYWORD MEANING AND SAMPLE 

(WITH ALTERNATES) 



(NO KEYWORD) 



ACNTPTR 

BOT 
DCTX 
DEL 
DEVCPTR 

DEVPTR 

DS 

EAADDR 

EACSA 

EAINTLB 

EAINTNR 



FOR MrSTDLB, THE LABEL TO BE AFFECTED. 

FOR M:ASSIGN OR M:GETASN, THE DCB CONCERNED. 

FOR M: MEDIA, A DCB FOR THE FILE TO LIST 

(MUST BE FIRST PARAMETER. REOUIRED EXCEPT FOR MEDIA) 

MrSTDLB «LO' 

M: ASSIGN DCBADDR 

ADDRESS OF 2-WORD BLOCK CANTAINING A 

FILE ACCOUNT NAME. MAY BE INDIRECT. 

M: ALLOT ( ACNTPTR, XXXX) OR (ACNTPTR, «XXXX) 

FIRST SECTOR OF FILE, OR ADDRESS OF SAME 

M:GETASN DCB, (BOT) OR (BOT,«XXXX) 

DCT INDEX OF DEVICE CONCERNED, OR POINTER TO SAME 

MrGETASN (DCTX,0) OR (DCTX,»XXX) 

DELETE SOURCE FILE AFTER MEDIA LISTING 

M:MEDIA (FILPTR,XXX),DEL 

ADDRESS OF 3-WORD BLOCK FOR DISK TRACKS PER 

CYLINDER, SECTORS PER TRACK, AND WORDS PER 

SECTOR. MAY BE INDIRECT. 

MrGETASN (DEVCPTR, XXXX) OR (DEVCPTR, »XXXX) 

ADDRESS OF A 2-WORD BLOCK TO CONTAIN AN EBCDIC 

DEVICE NAME (MAY BE INDIRECT) 

MrSTDLB 'LO* .(DEVPTR, XXXX) OR (DEVPTR, «XXXX) 

DOUBLE-SPACED MEDIA LISTING 

MrMEDIA (FILPTR,XXX) ,DS 

END ACTION TRANSFER ADDRESS 

M r STDLB • LO • , EAADDR , XXXX ) 

END ACTION COMPLETION STATUS ADDRESS 

MrSTDLB 'LO', (EACSA, XXXX) 

END ACTION INTERRUPT LABEL 

MrSTDLB 'LO' , EAINTLB, 'I3» ) 

END ACTION INTERRUPT NUMBER 

MrSTDLB 'LO' , EAINTNR, X'65' ) 
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GROUP 17: (CONTINUE) 



ENO 

EOT 

ERR, ERROR 

FILPTF 

FOR.ORG 

IGNERR 
MODLPTR 

NVFC 

OPLB 
PRIO 

REL 
RSI.GSI 

TIME 
TYC 
WAIT 
WP 

ZERO 



ENOUEUE ON THE REFERENCED DEVICE IN STDLB 

M.-STDLB 'LO'.fDEVPTR.XXXXj.ENC 

LAST SECTOR OF FILE, OR ADDRESS OF SAME 

MiGETASN DCB.(EOT) OR (EOT,«XXXX) 

ERROR RETURN ADDRESS (HAY BE INDIRECT) 

M:STDLB 'LO'^ERR.XXXX) OR (ERF,«XXXX) 

ADDRESS OF A 3-WORD BLOCK TO CONTAIN AN AREA NAME, 

RIGHT-JUSTIFIED, IN THE FIRST WOPD, AND A FILE NAME, 

EXTENDED TO 8 BYTES WITH TRAILING BLANKS, IN THE 

SECOND AND THIRD WORDS (MAY BE INDIRECT) 

MrSTDLB »L0' , (FILPTR.XXXX) OF (FILPTR,»XXXX) 

FILE ORGANIZATION OF FILE CONCERNED, OR POINTER 

TO SAME 

MrGETASN (FOR.O) OR (FOR,»XXX) 

IGNORE ERRORS (ABORT OVERRIDE) 

M:STDLB 'LO*, IGNERR 

ADDRESS OF A WORD TO CONTAIN AN EBCDIC MODEL NUMBER 

(MAY BE INDIRECT) 

MrGETASN DCB, (MODLPTR, XXXX) OR (MODLPTR, »XXXX) 

NO VERTICAL FORMAT CONTROL INTERPRETATION 

FOR MEDIA LISTING 

MrMEDIA DCB, NVFC 

OPLABEL TO BE REFERENCED, OR ADDRESS OF SAME 

HrSTDLB 'LOMOPLB.'LL') OR (OPLB,»XXXX) 

PRIORITY AT WHICH OPERATION IS TO BE DONE 

(OR ADDRESS OF SAME) 

M:MEDIA (PRIO.X'FFFF* ) OR (PRIO,»XXXX) 

RELEASE THE CURRENT ASSIGNMENT OF AN OPLABEL 

M: STDLB 'LO'.REL 

RECORD OR GRANULE SIZF (RESPECTIVFLY FOR BLOCKED OF 

UNBLOCKED FILES) OF THE FILE CONCERNED, 

OR POINTER TO SAME 

MrGETASN (GSI.O) OR (GSI,»XXX) 

TIMEOUT INTERVAL 

M:STDLB «L0' , (TIME, 50) 

RESERVE A COMPLETION STATUS WORD IN THE FPT 

MrSTDLB «L0' ,TYC 

WAIT FOR COMPLETION BEFORE RETURN 

M:STDLB 'LO'.WAIT 

WRITE RESTRICTION CODE FOR DISK AREA, OR 

ADDRESS OF SAME. 

MrGETASN (WP,0) OR (WP,«XXXX) 

EXPLICIT ZERO ASSIGNMENT OR STDLB 

M:STDLB »LO',ZERO 



NAME 

M:DFMODE 

M:DRC 

M:VFC 



GROUP 19 • • • • • 

CAL FPT CODE 

CAL1.1 X'22' 
CAL1.1 X'OB* 
CALI.1 X'05' 



KEYWORD MEANING AND SAMPLE 

(WITH ALTERNATES) 



(NO KEYWORD) 

ASC 

BCD 

BIN 



DCB CONCERNED (REOUIRED FIRST PARAMETER) 

MtDFMODE DCBADDR 

TAPE DRIVE PERFORMS ASCII TRANSLATION 

M:DFMODE DCBADDR, (ASC) 

BCD MODE DATA 

M:DFMODE DCBADDR.BCD 

BINARY MODE DATA 

M:DFMODE DCBADDR.BIN 
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GROUP 19: 


(CONTINUED) 


DRC 


DIRECT RECORD CONTROL ON KEYBOARD-PRINTER 




M:DRC DCBADDR, DRC 


D800 


TAPE DENSITY IS 800 CPI 




MrDFMODE DCBADDR, (D800) 


D1600 


TAPE DENSITY IS 1600 CPI 




MrDFMODE DCBADDR, (D1600) 


EBC 


TAPE DRIVE PROVIDES EBCDIC TRANSLATION 




MrDFMODE DCBADDR, (EBC) 


GSI 


FILE GRANULE SIZE IN BYTES (OR ADDRESS OF SAME) 




M:DFHODE DCBADDR, (GSI ,30) OR (GSI,«XXX) 


NODRC 


NORMAL RECORD CONTROL ON KEYBOARD-PRINTER 




H:DRC DCBADDR, NODRC 


NOVFC 


DO NOT INTERPRET VERTICAL FORMAT CONTROL 




M:VFC DCBADDR, NOVFC 


NRT 


NUMBER OF RETRIES (OR ADDRESS OF SAME) 




MrDFMODE DCBADDR, (NRT, 5) OR (NRT,»XXX) 


ORG, FOR 


FILE ORGANIZATION (OR ADDRESS OF SAME): U (UNBLOCKED), 




B (BLOCKED), OR C (COMPRESSED) 




MrDFMODE DCBADDR, (ORG, C) OR (ORG,»XXX) 


PACK 


PACKED DATA FORMAT 




MrDFMODE DCBADDR , BIN, PACK 


RSI 


RECORD SIZE IN WORDS (OR ADDRESS OF SAME) 




MrDFMODE DCBADDR, (RSI, 30) OR (RSI,»XXX) 


UNPK 


UNPACKED DATA FORMAT 




MrDFMODE DCBADDR, BIN, UNPK- 


VFC 


INTERPRET VERTICAL FORMAT CONTROL 




Mr VFC DCBADDR, VFC / 




NAME CAL FPT CODE 




MrBIOSTP CAL 1,5 X'OE' 




MrBIOSTRT CAL1.5 X'OF 1 




MrlOACT CALI.5 X«17' 




MrlODEACT CAL1.5 X' 16' 




MrSIOSTP CAL1.5 X«10» 




MrSIOSTRT CAL 1,5 IMP 


KEYWORD 


MEANING AND SAMPLE 


DCB 


ADDRESS OF DCB ASSIGNED TO THE DEVICE CONCERNED 




MrSIOSTP (DCB.XXXX) 


DEV 


AFFECT ONLY THE DEVICE, NOT ITS CONTROLLER 




MrSIOSTP DEV 


DEVX 


DCT INDEX OF DEVICE CONCERNED 




MrSIOSTP (DEVX, 5) 


HIO 


ISSUE AN HIO TO THE DEVICE CONCERNED 




MrSIOSTP HIO 


IOP 


AFFECT THE IOP, NOT JDST THE DEVICE OR CONTROLLER 




MrSIOSTP IOP 


OPLBX 


INDEX OF OPLABEL ASSIGNED TO DEVICE CONCERNED 




MrSIOSTP (OPLBX.it) 


PRADDR 


I/O PREEMPTION TRANSFER ADDRESS 




MrlODEACT 'LO' , (PRADDR, XXXX) 5 


PRCSA 


I/O PREEMPTION COMPLETION STATUS ADDRESS 




MrlODEACT 'LO* , (PRCSA, XXXX) 


PRINTLB 


I/O PREEMPTION INTERRUPT LABEL 




MrlODEACT 'LO' , (PRINTLB, »I3« ) 


PRINTNR 


I/O PREEMPTION INTERRUPT NUMBER 




MrlODEACT 'LO' , (PRlNTNR.X'es* ) 



Figure A-l. Specific CAL-Parometer Groups (cont. ) 



286 Appendix A 







NAME CAL FPT CODE 




M:HIO CAL1.5 X'15' 




M:SIO CALI.5 X' 12* 




M:TDV CAL1.5 X'lH' 




M:TIO CALI.5 XU3' 


KEYWORD 


MEANING AND SAMPLE 


DCB 


ADDRESS OF DCB ASSIGNED TO THE DEVICE CONCERNED 




M:SIO (DCB, XXXX) 


DEVX 


DCT INDEX OF DEVICE CONCERNED 




M:SIO (DEVX, 5) 


DIAG 


OPERATION WILL BE VALID ONLY IF DEVICE 




IS IN DIAGNOSTIC MODE 




M:SIO DIAG 


EAADDF 


END ACTION TRANSFER ADDRESS 




M:SI0 (EAADDR.XXXX) 


EACSA 


END ACTION COMPLETION STATUS ADDRESS 




M:SIO (EACSA, XXXX) 


EAINTLB 


END ACTION INTERRUPT LABEL 




M:SIO (EAINTLB, 'I3') 


EAINTNR 


END ACTION INTERRUPT NUMBER 




M:SIO (EAINTNR, X'65') 


OPLBX 


INDEX OF OPLABEL ASSIGNED TO DEVICE CONCERNED 




M:SIO (OPLBX, U) 


SIO 


IOCD ADDRESS 




M:SIO (SIO, XXXX) 


TIME 


TIMEOUT INTERVAL 




M:SIO (TIME, 50) 




M:DCB GENERATES A DCB AT THE POSITION OF THE 




PROCEDURE REFERENCE 


KEYWORD 


MEANING AND SAMPLE 


(WITH ALTERNATES) 


ABA.ABN 


ABNORMAL ADDRESS 




M:DCB (ABN.XXXX) 


ACNT 


FILE ASSIGNMENT; FILE ACCOUNT NAME IS PARAMETER 




M:DCB (ACNT,»ACC 123*) 


AREA 


FILE ASSIGNMENT; AREA NAME IS PARAMETER 




M:DCB (AREA.'FP*) 


AREAX 


FILE ASSIGNMENT; AREA INDEX IS PARAMETER 




M:DCB (AREAX, L),(FILEN, •NONZERO* ) FOR FILE; 




M:DCB (AREAX, 1),(FILEN,0) FOR WHOLE AREA 


ASC 


TAPE DRIVE PERFORMS ASCII TRANSLATION 




M:DCB (ASC) 


BIN 


BINARY MODE 




M:DCB (BIN) 


BTD 


BYTE DISPLACEMENT OF FIRST BYTE IN FIRST WORD OF BUF 




M:DCB (BTD, 3) 


BUF 


BUFFER ADDRESS 




M:DCB (BUF, XXXX) « 


DEV 


DEVICE ASSIGNMENT; DEVICE NAME IS PARAMETER 




M:DCB (DEV, , LPA02») 


DEVX 


DEVICE ASSIGNMENT; DCT INDEX IS PARAMETER 




M:DCB (DEVX, 5) 


DFAREA 


FILE ASSIGNMENT WITH DEFAULT AREA INDICATED. 




HAS NO PARAMETER. 




M:DCB DFAREA, (FILE, 'FILENAME* ) 
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DRC 

D800 

D1600 

EBC 

EFA.ERR, ERROR 

FILE 

FILEN 

LIST<L 

NRT, TRIES 

OPLB 

OPLBX 

PACK 

RSZ,RECL 

TTL 

¥FC 

ZERO 



KEYBOARD-PRINTER I/O VITH DIRECT RECORD CONTROL 

M:DCB (DRC) 

TAPE DENSITY IS 800 CPI 

M:DCB (D800) 

TAPE DENSITY IS 1600 CPI 

M:DCB (DI600) 

TAPE DRIVE PROVIDES EBCDIC TRANSLATION 

M:DCB (EBC) 

ERROR ADDRESS 

M:DCE (ERR.XXXX) 

FILE ASSIGNMENT; FILE AND OPTIONAL AREA 

NAMES ARE PARAMETERS 

M-.DCB (FILE, 'FP', 'FILENAME') 

OR 

(FILE, 'FILENAME') 
FILE ASSIGNMENT; FILE NAME IS PARAMETER 
M:DCB (FILEN, 'GIRAFFE') 
LISTING DEVICE 
M:DCB (L) 
NUMBER OF RETRIES 
M:DCB (NRT, 3) 
OP LABEL ASSIGNMENT; 
M:DCB (OPLB,'LO') 

OP LABEL ASSIGNMENT; OP LABEL INDEX IS PARAMETER 
M:DCB (OPLBX.l) 

7-TRACK BINARY TAPE< PACKED FORMAT 
M:DCB (PACK) 
RECORD LENGTH IN BYTES 
M:DCB (RECL,80) 
LENGTH OF DCB IN WORDS 
M:DCB (TTL, 7) 

INTERPRET VERTICAL FORMAT CONTROL CHARACTERS 
M:DCB (VFC) 

EXPLICIT ZERO ASSIGNMENT 
M:DCB (ZERO) 



OP LABEL NAME IS PARAMETER 



J 



Figure A-l. Specific CAL- Parameter Groups (cont.) 



288 Appendix A 



APPENDIX B. XEROX STANDARD COMPRESSED LANGUAGE 



The Xerox Standard Compressed Language is used to represent 
source EBCDIC Information in a highly compressed form. 

Several Xerox processors will accept this form as input or 
output, will accept updates to the compressed input, and 
will regenerate source when requested. No information is 
destroyed in the compression or decompression. 

Records may not exceed 106 bytes in length. Compressed 
records are punched in the binary mode when represented on 
card media. Therefore, on cards, columns 73 through 80 
are not used and are available for comment or identification 
information. This form of compressed language should not 
be output to "compressed" files since the I/O compression 
may cause loss of data. 

The first four bytes of each record are for checking purposes. 
They are as follows: 

Byte 1 Identification (00L 11000). L = 1 for each 
record except the last record, in which case 
L =0. 

Byte 2 Sequence number (0 to 255 and recycles). 

Byte 3 Checksum, which is the least significant 

eight bits of the sum of all bytes in the rec- 
ord except the checksum byte itself. Carries 
out of the most significant bit are ignored. 
If the checksum byte is all l's, do not 
checksum the record. 

Byte 4 Number of bytes comprising the record, in- 
cluding the checking bytes (<106). 

The rest of the record consists of a string of six -bit and 
eight-bit items. Any partial item at the end of a record 
is ignored. 

The following six4»it items (decimal number assigned) com- 
prise the string control: 



Six-Bit 




Decimal 




Item 


Function 





Ignore . 


1 


Not currently assigned. 


2 


End of line. 


3 


End of file. 


4 


Use eight-bit character which follows. 


5 


Use n + 1 blanks, next six-bit item is n. 


6 


Use n + 65 blanks, next six-bit item is n 


7 


Blank. 


8 





9 


1 


10 


2 



Six -Bit 




Decimal 




Item 


Function 


11 


3 


12 


4 


13 


5 


14 


6 


15 


7 


16 


8 


17 


9 


18 


A 


1? 


B 


20 


C 


21 


D 


22 


E 


23 


F 


24 


G 


25 


H 


26, 


I 


27 


J 


28 


K 


29 


L 


30 


M 


31 


N 


32 


O 


33 


P 


34 


Q 


35 


R 


36 


S 


37 


T 


38 


U 


39 


V 


40 


W 


41 


X 


42 


Y 


43 


Z 


44 


^ 


45 


< 


46 


( 


47 


+ 


48 


1 


49 


& 


50 


$ 


51 


* 


52 


) 


53 


t 


54 


— i 


55 


- 


56 


/o 


57 


1 


58 


% 


59 


U-J 


60 


> 


61 


• 


62 


1 


63 


= 
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APPENDIX C. HEAL-TIME PERFORMANCE DATA 



The following timing data was determined fo.- Sigma 9 
hardware. Xerox 550 hardware if somewhat slower. 



RESPONSE TO INTERRUPTS BY CENTRALLY 
CONNECTED TASKS 

The time used by the system to save the interrupted context 
and establish the interrupting task context is approximately 
45 usee assuming that 16 registers are being saved. This 
time includes the XPSD in the interrupt location context 
and represents the total time between the interrupt be- 
coming active and the start of execution of the first in- 
struction in the task (assuming no interruption by a higher 
priority task). 



I/O INTERRUPT 

Following successful completion of an I/O device access, 
the I/O interrupt will remain active for approximately 
150 usee, assuming that no higher priority interrupts have 
become active during this period and that cleanup is de- 
ferred to an interrupt level other than I/O. Upon clearing 
the I/O interrupt, the system proceeds at the priority level 
of the interrupted task or at the cleanup level if its priority 
is higher than that of the interrupted task. 



If I/O cleanup deferral was not requested at SYSGEN, 
the I/O request will be cleaned up at the I/O interrupt 
level. 



INTERRUPT INHIBITS 

At times CP-R must inhibit the interrupt system. The inhibit 
time is typically less than 100 psec. 



SECONDARY TASK DISPATCH TIME 

The amount of time required for the system to dispatch a sec- 
ondary task is approximately given by 



time (in usee) = 15T + 198 + 2J (*4 + -98 Pn) 

n=l 



where 
T 



is the number of tasks in the dispatcher queue 
that are higher in priority than the task being dis- 
patched but which are not currently di spat enable. 

is the number of segments in the task being 
dispatched. 

is the number of pages in the nth segment. 



CONSOLE INTERRUPT 

The Console Interrupt remains active for less than 30 usee. 
During this time, a flag in the Control Task is set to indi- 
cate the occurrence of the interrupt and the Control Task 
interrupt is triggered. 



OVERLAY LOADING 

Overlay loading is accomplished with a negligible percent- 
age of total time devoted to non-l/O system activity. For 
example, on the Model 7202/7204 RAD, a 1400-word over- 
lay requires approximately 50 msec, assuming average la- 
tency (17 mils) and I/O transfer time of 34 msec. To this 
must be added the time waited to gain access to the RAD 
(time of request, if any in progress, plus the time of any 
higher priority requests). 
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APPENDIX D. COOPERATIVES AND SYMBIONTS 



In CP-R the routines fo perform card reader and/or line 
printer operations operate concurrent!/ with the jobs being 
run. The peripheral system is composed of a "cooperative" 
and a *%ymbiont" or symbionts. The cooperative is a mon- 
itor routine colled as a result of a user's (/O request, 
whereas a symbiont is a monitor routine that is initiated 
either by the action of the cooperative or by operator com- 
mand from the system console. The cooperative is used to 
transfer information between the user's program and secon- 
dary (disk) storage, and symbionts are used to transfer In- 
formation between secondary storage and peripheral devices 
(see Figure D-l). 

The symbiont-cooperative system provides for complete buf- 
fering between I/O devices and the user's program. There- 
fore, a user's program never has to wait for an I/O device 
to complete an action. Also, the current job may be run- 
ning while the output of the previous job and the job 
file for the following job are being handled by symbiont 
operation. 



COOPERATIVE 

A single cooperative is provided for handling both user in- 
put and output files. It is reenterable and can handle any 
number of device-type files (printer, card reader) per job. 



SYMBIONTS 

Symbionts execute as a mapped task in the CP-R job and 
control the action of a symbiont dedicated ^O device 
having a lower transfer rate than secondary storage. Core 
storage as well as secondary storage will be used by the 
symbiont to produce a continuous flow of information to or 
from these devices. Symbionts will transfer information 
from a peripheral device to the disk and from the disk to a 
peripheral device. 

Unlike the user's program, which is directed primarily by 
control commands, symbionts — once initiated — receive 
all their control from the operator's console. An input 
symbiont device can be initiated only by the console op- 
erator, while an output symbiont device can be initiated 
either by the operator or the cooperative. 

For each device, the symbionts perform one operation at a 
time with no wait. When no more operations can be ini- 
tiated, the symbiont task goes inactive. When any of the 
initiated services is completed, the symbiont task TESTS 
(CHECK) the completed service and resumes execution fol- 
lowing the call that was completed. 

Since symbionts are reenterable, a single symbiont may 
drive several types of devices. For example, the same 
symbiont may be used to drive many printers and card 



readers. All the peripheral-dependent information Is 
contained in monitor rabies. 

A single symbiont is provided in the monitor which handles 
all standard line printers, card readers, and magnetic tapes. 



SYMBIONT-COOPERATIVE HOUSEKEEPING 

Two monitor subroutines are provided for automatic main- 
tenance of core storage. One is used to release a blocking 
buffer after use by the symbionts, and the other is used to 
obtain a blocking buffer. If a blocking buffer is requested 
by a symbiont and none is available, the symbiont waits for 
five seconds and requests again. When one becomes avail- 
able, normal symbiont activities continue. As each buffer 
is emptied, either by reading from or storing into secondary 
storage, it is released. This procedure allows for efficient 
utilization of blocking buffers. 

The symbiont routines consist of a permanently resident por- 
tion in monitor space and a nonresident portion which exe- 
cutes in the monitor overlay area. After starting an I/O 
or selected operation on every applicable symbiont device, 
the symbiont relinquishes control to the monitor. 

Two disk areas are used to separate input from output sym- 
biont data; the Input Symbiont (IS) area and the Output 
Symbiont (OS) area. The sizes are installation dependent 
and are set up at SYSGEN. Each area contains compressed 
format files which are fixed in size, the size being a SYS- 
GEN parameter. 

When the input symbiont reads a DOB card, a file is cre- 
ated in the IS area. The file name is based on on internal 
sequential number, job ID, which is used for the symbiont 
key-ins. Input from the device to the file continues until 
a IJOB or 1FIN card is read at which time a new file is 
created or the symbiont is suspended. If the file size is 
not large enough to contain all the records for a job, a 
continuation file is allotted which is readily identifiable 
as a continuation of the previous file. 

A file is created in the OS area by the output cooperative 
when a user writes to a symbiont device. The file name is 
based on the executing job's number. Output to the file 
continues until the file is out of space or a new job begins 
to execute. When a file has run out of space, a continu- 
ation file (still based on the executing job's number) is de- 
fined. If a new job has begun to execute, a file with a 
new identifying job number is defined. - 

A file in the IS area is deleted by the input cooperative 
when a read results in an end-of-file indication from file 
management. Files in the OS area are deleted by the 
output symbiont. The files will normally be deleted all at 
once at the end of the job. This allows backspacing of 
printer output. However, If the DO key-in is in effect, 
the files will be deleted as they are output. 
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Figure D-l. Information Flow Through Cooperative and Symbionrs 
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APPENDIX E. JCP LOADER 



In addition to loading the Overlay Loader and RADEDIT 
Into their respective flies In the SP area at SYSGEN 
time (see ILOAD command in Chapter 2), the JCP Loader 
can be used to load some user programs. Within the restric- 
tions given below, both nonsegmented and segmented pro- 
grams can be loaded onto the disk for subsequent execution . 



This example toads a background program from a 9-track 
tape onto the FCOPY file in the BP area. The program 
will be loaded to execute at 6100^ (EXLOO6100). The 
program can consist of an/ number of object modules, but 
the last object module must be followed by an EOF. The 
object modules must obey the restrictions specified for the 
JCP Loader (see above). 



LOADING NONSEGMENTED PROGRAMS 

1. The last object module in the program being loaded 
must be terminated by an IEOD command. Any num- 
ber of object modules can be loaded. 

2. The object module cannot contain any of the following 
load items: declare dummy section, declare secondary 
external reference name, forward reference definition, 
or odd or subtract absolute section. The field (in a 
define field lood item) cannot cross a word boundary. 

3. FORTRAN compiled programs or programs assembled 
with basic Symbol, or programs using the LOCAL di- 
rective cannot be loaded with this Loader. 

4. The JCP Loader creates the OVLOAD and DCB table 
and the M:SL DCB. The user must code the complete 
PCB except for the OVLOAD table address, the DCB 
table address, and the M:SL DCB oddress. The user 
must also code all DCBs (except M;SL), the Temp Stack 
and all other tables referenced in the PCB. 



LOADING SEGMENTED PROGRAMS 

For loading a program with overlay segments, the above 
restrictions plus the following restrictions apply: 

1. The only overlay structure allowed is a root plus one 
level of overlay. 

2. The root must be the first group of object modules 
looded and must be terminated by an IEOD command. 
Each group of object modules loaded after the root and 
terminated with an IEOD command will consist of one 
overlay segment and will be attached to the end of the 
root. Each overlay segment will be assigned a segment 
identification of 1 to n, where 1 is assigned to the first 
segment loaded, 2 assigned to the second segment 
loaded, etc. The segment identification is used in 
calling in an overlay segment at execution time. 

3. The number of overlay segments must be correctly stated 
on the ILOAD command. 



5. The PCB must be the first data loaded in the root. 

6. Simplified Memory Management is assumed (see the 
"Overlay Loader" chapter, in the paragraph concern- 
ing the SMM option on the IOLOAD command). 

Example: 

Load a nonsegmented background program onto its perma- 
nent file: 

:LOAD (1N,9TA82),(OUT,BP,FCOPY),(EXLOC,6100) 



For multisegment programs, the JCP Loader builds the 
OVLOAD table at the end of the root and allocates seven 
words for the M:SL DCB. The entry address for each over- 
lay is taken from the last encountered start item and placed 
in the OVLOAD table along with the load address, byte 
count, and segment identification. 

The JCP Loader writes the program in core image format 
onto the appropriate file. The oddresses and names of all 
M: or F: DEFs will be used by the Loader to create the DCB 
table. The loaded program can be executed via the RUN, 
ROV, or Name command, depending upon which disk file 
the program was loaded on. Note that the Loader never 
loads a program directly into core memory. 
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APPENDIX F. SYSTEM INITIALIZATION AND PATCHING 



Modification of the resident CP-R system (including all 
system tables), CP-R overlays, and Job Control Processor 
can be performed at system boot time through patches de- 
fined on IMODIFY control commands. Any number of 
IMODIFY commands can be input, and the stack is termi- 
nated by a single 1END command. The system is notified 
that patching is to take place by sense switch settings that 
are set prior to CP-R initialization. 

During CP-R initialization, the Control Panel interrupt is 
inhibited so that a premature key-in will not prevent the 
completion of initialization. 

At the end of initialization, the message 

PLEASE KEYIN DATE AND TIME 

will be output on the OC device. The operator must re- 
spond with the DT key-in. Any other key-in is considered 
to be an error. 

As each IMODIFY command is processed, the overloy is 
read into core, modified, and written out to the system 
disk. Note that unused disk space between the end of 
an overlay and the end of an overlay's file (that is, unused 
space on the last sector of an overlay) can be used for a 
patch area. 



WPUT OPTIONS 

Sense switch (SSW) settings are used to select initialization 
options following a system boot. Because SSW's are used in 
SYSGEN also, care must be taken to allow for the system 
boot which follows the SYSGEN process. 

Foreground programs which are designated resident are 
normally loaded during the initialization process. The 
periodic scheduler is also normally reactivated to resume 
these tasks. Both may be prevented by setting SSW4. No 
other functions are affected by the setting of SSW4. 

Modify control commands and quick patch commands are 
input depending on the settings of SSWl, SSW2, and 
SSW3. 



Setting SSWl selects the C device for MODIFY command 
input. Setting SSW2 selects the OC device for MODIFY 
command input. Setting SSWl and SSW2 causes the ini- 
tialization process to hang following a WAIT instruction 
before any processing has been done. This allows the sense 
switch settings to be changed or any critical hand patching 
to be done before MODIFY or quick patch commands are 
read. 



SSW3 set causes quick patch commands to be read from the 
some device as the MODIFY commands. If SSWl and SSW2 """ 
are reset, the setting of SSW3 is ignored. 

Setting Meaning 

XXXO Load Resident foreground programs 

XXXI Don't load resident foreground programs 

1 1 XX Hang at the start of initialization 

OOXX Read no MODIFY or quick patch commands 

100X Read MODIFY commands from C device 

010X Read MODIFY commands from OC device 

101X Read MODIFY and quick patch from 

C device 

011X Read MODIFY and quick patch from 

OC device 



QUICK PATCHES 

Quick patches may occur at the beginning of the initializa- 
tion process and use none of the system services. Because of 
this, they may be used to patch portions of the system 
used during the reading and processing of MODIFY com- 
mands. Also modifications to the early portions of the 
initialization processor may be mode. 

SSW3 set selects the reading of quick patches from either 
the C or OC device. SSWl and SSW2 are used to indicate 
which device. Unlike the MODIFY commands, quick 
patches assume that the C device is a card reader and that 
the OC is a TTY type device. The reading of quick patches 
is always followed by the reading of MODIFY commands. 

The format for quick patches is: 

loc[+] value[+] 

where 

loc specifies the hex location of the location to 
be patched. A trailing + indicates* that CP-R 
relocation bias is to be added. 

value specifies the value to be stored in that loca- 
tion. A trailing + indicates that CP-R relocation 
bias is to be added. 

Quick patching is terminated by a blank card when reading 
the C device, and a NL when reading from the OC device. 
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PATCH COMMAND FORMATS 

In the 1MODIFY control commands listed below, the 
brackets only indicate options available in the specifica- 
tion field and are not actual!/ used in the MODIFY state- 
ments; the indicated parentheses and commas are required. 
The general format for (MODIFY commands is 

/, M o DI fy (|;X*:£})- h-h;kh<-. . o 



PATCH SYSTEM OVERLAY OR JCP 



where 



symbol specifies either a table name or a resident 
overlay name, 

module specifies one of the modules described be- 
low to be patched. 

loc specifies the initial hexadecimal location to be 

modified and is relative to the beginning of the 
named module (for ABS, loc is relative location 0). 

value specifies the hexadecimal value to be in- 
serted in the location. Successive values go in 
successive locations. The value field may be 
repeated and has an alternate form. 

(value, symbol) 

where symbol is either a table name or an overlay 
name, whose value will be added to the value 
field. This alternate form for the value field is 
also valid for all the examples shown on this page. 



MODIFY (OLAY,name,loc),[x] volue[,[x] value. 



L 



ZI 



• . . [x] value] 



where name is defined in the SYSGEN map under "CP-R 
Program Allocation" as the first entries. The size (non- 
resident) or base address (resident) of each overlay accom- 
panies its name. 



PATCH SIMULATION ROUTINE 



IMODIFY (SROU,name,loc),[x]value[,[x] value, ... , 



I— [x]value] 
where name = FPSIM, DECSIM, BYTSIM, or CVSIM. 

PATCH CP-R MONITOR 

IMODIFY (CPR,loc),[x]value[,[x]value, . . .[x]volue] 

PATCH SYSTEM TABLES 

IMODIFY (ABS,loc),volue[,value, .. .value] 



D 



is the relocation flag indicating the address field 
of the value is to be relocated by adding the be- 
ginning address of any of the following: 

I is the Decimal Simulation start address. 

J is the JCP start address. 

L is the Floating-Point Simulation start 

address. 

M is the Monitor start address. 

O is the CP-R Overlay start address. 

P is the Patch area start address. 

R is the named module (tart address. 

V is the Convert Simulation start address. 

Y is the Byte-String Simulation start 
address. 

Z is the- module preceding the currant 
module. 



MODIFY PATCH AREA 



r 



IMODIFY (PATCH,loc),volue 



TRACE COMMAND FORMATS 

In the IMODIFY control commands listed below, the 
brackets only indicate options available in the specification 
field and are not actually used in the modify statements; 
however, the indicated parenthesis and commas are required. 
The general format for the IMODIFY command is 



IMODIFY 



(SETRACE f task[>ufferO vents]]) 

(TRACE, [°p F j )[>ntry poin»,entry pointed 



where 



SETRACE changes the three trace parameters that 
follow. It does not activate or deactivate CP-R 
tracing. 
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task may be used to selectively trace a tingle task. 
The value Is the value in the first byte of word 7 
of the user's TCB. The default is zero, which 
traces all tasks, 

buffer is an area to be used by the trace. This orea 
should be large enough for the trace routine, entry 
point* symbol table, and 24 words for eoch event 
traced; that is, = (17?2 10 + (24* events)). The de- 
taule is the foreground private area. 

events if the hexadecimal number of entries to trace 
before cycling over the oldest entry (this is a cir- 
cular trace). The default is X'100' events. 

TRACE activates (ON) or deactivates (OFF) the 
trace. If no entry point parameters exist, "ON" 
traces all entry points and "OFF" turns the trace 
completely off.' 

ON or OFF are described in TRACE, above. 

entry point activates (ON) or deactivates (OFF) 
each entry point listed. 

The user may obtain the circular trace stack by dumping 
memory beginning afbuffer". The EBCDIC option (if using 
the DM key-in) should be used to provide readable entry 
points and overlay names . The format of memory is as 
follows: 



ENTRY POINT 
(2 words) 
(16 registers) 



OVERLAY 
(2 words) 



PSD 

(2 words) 



4E &4F 
(2 words) 



CLEAR COMMAND FORMAT 

The CLEAR command is provided to initialize file area 
directories to contain no files. It may be of particular use 
to clear the symbiont areas when an IS/OS inconsistency is 
reported at boot time, or to initialize areas SYSGENed but 
not saved when booting a SAVE tape. It is important to be 
aware that this command only zeroes the first sector of the 
area, to give an empty file directory, it does not zero the 
whole area. 

The form of the commond is 

A 



ICLEAR AA[, AA, . . .] 



where AA is the name of on area to be given an empty file 
directory. 



!END COMMAND FORMAT 

The IMODIFY control eommand(s) must be followed by a 
terminating IEND command with the form 



/iend[cpr] 



where CPR indicates that the copy of the CP-R resident on 
the system disk is to be replaced by the current version of 
CP-R in core. 



Four words of EBCDIC Xs will follow the last event traced. 
If the circular stack has been fully used, the Xs will also 
appear at the end of the stack. 



See "SYSGEN" for a discussion of entry points and overlay 
names. 



SYSTEM PATCHWG AND TRACING DIAGNOSTICS 

The diagnostic messages in Table F-l will be output on 
the OC device for a corresponding error in sense switch 
settings or IMODIFY commands. 



Table F-1. System Patching Diagnostics 



Message 


Meaning 


Action 


IIERROR ITEM XX -CORRECT . 


If this is OC, only the message portion 
preceding the hyphen is output. If not 
OC, the entire message is output. 


If this is OC, input next 
command. If not OC, 
idle machine, increment 
address, and RUN. 


1 AND CLEAR B S 


MPATCH LOC ERR -CORRECT 


If this is OC, only the message portion 
preceding the hyphen is output. If not 
OC, the entire message is output. 


If this is OC, input next 
command. If norOC, 
idle machine, increment 
address, and RUN. 


1 AND CLEAR B S 


1 INO PATCH AREA - CLEAR . 


If this is OC, only the message portion 
preceding the hyphen is output. If not 
OC, the entire message is output. 


If this is OC, input next 
command. If not OC, 
idle machine, increment 
address, and RUN. 1 


1 B $ IGNORES MODIFY 1 


1 

1 COMMAND 
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APPENDIX & CHARACTER-ORIENTED COMMUNICATIONS ROUTINES 



The COC Support Package provide* on-line terminal 
communications capability to CP-R users via a single 7611 
communications controller. The package is open-ended, 
and con be tailored to fit a user's particular application 
c extended to support other terminal types. It is also 
'apable of supporting other character-oriented communi- 
cations activities, such as store-ond-forward message 
switching. 

The set of reentrant subroutines that comprise COC can be 
included in a Public Library or loaded with user progrom(s) 
that call for COC support. In either cose, the Overloy 
Loader is used to link the package with the calling pro- 
gram (s). The package is only available to foreground user 
programs. 

The COC Support Package is capable of handling up to 64 
character-oriented terminals. The following devices can 
be supported: 



Device 



Xerox Model Number 



KSR-35 


7015 or 7025 


RO-35 


7016 or 7026 


ASR-35 


7017 or 7027 


KSR-37 


7018 



COC handles the following classes of communication mode 
and terminal device: 

• Simplex, capable of one-way communication only. 

e Half-duplex, capable of one-way transmission, but 
reversable. 

• Full-duplex, capable of simultaneous transmission in 
both directions. 

• Echoplex, a special case of full -duplex, where a 
character received from a terminal's keyboard must be 
sent back (i.e., "echoed") to the terminal to cause 
printing or display of the character. 



The package provides for input/output handling of mes- 
sages or arbitrary strings of characters. The input rou- 
tines will accept requests for input on specified lines, 
accumulate input characters into messages, ond deliver 
the messages to the user program upon request. The out- 
put routines deliver a message to a specified device. 
The package also provides for conversion between the 
EBCDIC character set used internally, and the external 
character set generated and/or recognized by the individual 
terminal device. Special characters are recognized and 
can cause special actions to be performed, such as message 
termination. 



COC uses a pool of buffers for I/O operations and input 
messages are accumulated in these buffers as they are 
received. Output messages are transferred to the buffers 
during code translation. The buffers ore dynamically allo- 
cated to the various lines, as needed. The size of the buf- 
fer pool is an assembly parameter that must be set large 
enough to accomodate the number, nature, ond speed of 
the devices supported. 

To a great extent, the COC Support Package is parameter- 
ized, and is driven by tables that define the characteristics 
of each device, the optional functions to be performed, and 
the code translation tables to be used. Special handling is 
provided for keyboard/displays operating either in charac- 
ter mode or in the optional message mode. Any one of three 
different control character modes may be selected, enabling 
the user to exercise greater control over the user -system 
dialogue. 

The COC Support Package is organized into three main 
groups: 

1. I/O command routines that accept user program calls 
for input, output, and status checking. 

2. I/O interrupt routines that service the externa I interrupt 
pair connected to the COC, and perform input character 
translation and buffering, special action checking, 
output character transmission, and end-of-messoge 
action; end-oction includes posting of status and, op- 
tionally, triggering of a specified external interrupt. 

3. COC database that includes COC parameters, line 
control tables, and code translation ond special 
action tables. 



SYSTEM INTERFACE 

The package provides the input/output interfacing between 
the computer and the 7611 COC controller and its associated 
terminal devices. The COC Support Package requires 1,226 
words of core memory, plus nine words per communication 
line ond four words per Buffer Pool block (see "Buffer Pool" 
later in this Appendix). 

The 76 11 COC requires an adjacent pair of externa I interrupts 
for signalling input and output events, respectively. The 
input (external) interrupt must have the higher priority of 
the two. The COC Support Package causes them to be 
centrally connected by executing a connect CAL for each, 
during execution of the initialization routine. 

Input from the COC equipment is through a single lOP chan- 
nel and is started by the initialization routine, CSTART. 
Data chaining is employed to cause the input to flow into 
a single ring buffer. The I/O interrupt is not used- An 
external interrupt pulse is generated each time a data char- 
acter (along with line identification number) is input. 
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Output to the COC equipment is vio the direct I/O system. 
Each data character is output (along with line identification 
number) by a Write-Direct instruction. When a transmitter 
in the COC is ready to send another character on a given 
line, an external interrupt signal is generated, and it 
remains set until a Write-Direct either sends another char- 
acter on the line or turns off the transmitter. 



USER PROGRAM INTERFACE 

The COC Support Package is first assembled to fit the 
requirements of the local installation and then linked to 
user programs. The package may be loaded and stored in 
executable form in a Public Library (generally the case if 
it is called by more than one user program) or it may be 
loaded with the calling program (s) and stored in a User 
Library. 

The interface between COC Support Package and user pro- 
gram is defined in three general areas: 

1. Assembly-time parameters supplied by the user to 
define his particular configuration. 

2. Line Control and other tables, available to the user 
program through DEF directives in the COC source 
deck. These describe the state of each line, its mode 
of operation, code conversion to be performed, etc. 

3. I/O commands issued in the form of subroutine calls. 
Since standard FORTRAN IV calling sequences are used, 
the user programs may be coded in AP or FORTRAN IV. 



PREPARATION AND USE OF COC 

Since the COC Support Package supports communications 
with many different devices in several different communi- 
cation modes, the package is highly parameterized, table 
driven whenever possible, and assembled specifically for 
each installation. The steps that must be performed to 
obtain an operational COC capability are as follows: 

1. Assemble the standard COC routines using the AP as- 
sembler, specifying the number of lines, types of ter- 
minals, size of buffer pool, conversions desired, etc. 
(see Table G-2). The Relocatable Object Module 
(ROM) generated may be stored in a System Library 
but this is not required (see Chapter 6) . 

2. Create a load module containing the COC Support 
Packoge and user program (s) that will interface with 
it. The I O LOAD command must specify the number 

of tasks included; two for the COC interrupts, plus any 
required by the user program (s). The load module must 
be stored in the foreground program area of the disk 
file (see Chapter 6). 

An alternative form of step 2 consists of loading the 
COC Support Package by itself and storing it in a 



Public Library. Separate calling programs may then 
be loaded onto RAD (in the FP area), with the COC 
Support Package identified in a PUBLIB option on each 
of the IOLOAD commands. 

Lood the program root into core memory and initiate 
execution of the user program (see Chapter 5). 

Execute (within the user program) the COC Initialize 
command CALL CSTART. Upon successful completion 
of this command, the COC Support Package and the 
7611 equipment will be ready to accept input/output 
commands. 



COC COMMANDS AND CALLING SEQUENCES 

The I/O calls available to user programs ore summarized in 
TableG-l. They all operate on a "no-wait" basis. That is, 
a call is accepted, the operation is begun and if the op- 
eration cannot be completed immediately, control is re- 
turned to the calling program. 



Table G 


-1. COC I/O Commands 


Command 


Function 


CALL CSTART 


Initiate COC activity. 


CALL CSET 


Set line table parameters. 


CALL C WRITE 


Write output to a terminal. 


CALL CREAD 


Accept input from a terminal. 


CALL CMOVE 


Move input to user area. 


CALL CHECK 


Check I/O line status. 


CALL CSTOP 


Terminate COC activity. 



Table 0-1 is intended for ready reference: more detailed de- 
scriptions of the commands, their functions, and the calling 
sequences for both FORTRAN and AP are given below. 



CALL CSTART (lertatt COC Activity) 

This commond initializes the COC Support Package, the 7611 
equipment and associated external inrerrupts^nd prepares 
the associated IOP channel for input. Optionally, CSTART 
may be called on to initiate activity on a single line, with- 
out affecting any of the others. Initialization and startup 
of the COC routines will be accomplished by the fol- 
lowing call: 

From FORTRAN programs, the call is 
CALL CSTART (line, status) 
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From assembly language programs, the call it 
U, 14 2 

BAL, 15 CSTART 

ARG. oddress of line-number variable (tee 

below). 

ARG- oddress of location where status is to be 

returned. 



This form of the calling sequence performs the following 
functions: 

1. Steps 1 through 3 under the "Turn On All Lines" 
procedure above, are executed only if th.s is the first 
call for COC initialization. 

2. Only the specified receiver is turned on (the appro- 
priate error notice is output if turn-on is unsuccessful). 

3. The status variable is updated as shown above. 



TURN ON ALL LINES 

If line number = 0, CSTART performs the following functions: 

1. Initializes the COC input buffer, the COC tempor- 
ary blocking buffers, and all pointers associated with 
them. 

2. Starts input on the IOP channel to which the COC is 
connected. 

3. Executes CONNECT CALs that centrally connect, arm, 
- and enable the external interrupts to which the COC 

is attached. 

4. Turns on all receivers. 

5. Types out error notifications on the operator's console 
if any receivers have not been successfully turned on. 

6. Returns control to the user program with status infor- 
mation stored in the indicated location, and coded as 
follows: 

Code Status 

Normal return. 

1 One or more receivers not turned on. 

2 COC already active: request ignored 
unless any lines were out of service. 

4 Unable to start COC. 

If the status code indicates that one or more receivers 
were not turned on, the user may issue the command 
CALL CHECK recursively to determine the actual 
Status of the lines of interest. 

This form of the call may also be given when some of 
the receivers have already been turned on. In this 
case, only steps 4 and 5 art executed, as appropriate. 

TURN ON SPECIFIC LINE 

If a user program must initiate I/O activity with a speci- 
fic line, the line number variable is set equal to the 
number of the line to be started and the above catling 
sequence is executed. 



CALL CSET (Set Line Table Pmewtert) 

This command is used to alter parameters describing the type 
and mode of operation of the terminal connected to a speci- 
fied line. To change the mode and/or terminal type for 
a specific line, the following coll may be executed: 

From FORTRAN programs, the call is 

CALL CSET (line-number, mode, rerminol type) 

From assembly language programs, the call is 
U,14 3 

BAL, 15 CSET 

ARG. oddress of line number variable. 

ARG. address of mode variable. 

ARG. oddress of terminal-type variable. 

The mode variable may have the following decimal volues: 
Mode Value Meaning 



1 
2 
3 

4 

16 

132 
>255 



Simplex (input only). 

Simplex (output only). 

Full-duplex. 

Half-duplex (i. e. , local-printing, 
no echo). 

No-translate mode fr>*i f her input 
nor output characters are to be 
translated). ^ 

Echoplex (i.e., Full-duplex, sim- 
ulating half-duplex). 

No change. 



Note that the no-translate value must be added to one or 
the other valid mode values. 
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The terminal type variable may have the following values: 
Type Value Meaning 






Model 33 Teletype 


1 


Mode 35 Teletype. 


2 


Model 37 Teletype 


>255 


No change. 



The above values are identical to those contained in the 
line control table COCTERMN. New values may be 
created to handle new terminals, but the Input and Output 
Translate Pointer Tables (COCIT and COCOT, respectively) 
must be expanded accordingly. 



CALL CWRITE (Write Oetpit U ■ T«aiml) 

This command is used to perform the following functions: 

1. Convert the indicated character string from the internal 
EBCDIC representation to the code set recognized by 
rh e sped fi ed termi na I . 

2. Store the converted character string in the COC buf- 
fer pool. 

3. Update the appropriate line control data. 

4. Start output to the terminal if it is not already in 
progress. 

5. Return control to the user program. 

Output will be started or continued by executing the fol- 
lowing call: 



From FORTRAN programs, the call is 

CALL CWRITE (line, data, displacement ,byte-count, 



3 



-status [, end]). 
From assembly language programs, the call is 
U, 14 5 (or 6). 

BAL, 15 CWRITE 



ARG 



ARG- 



oddress of line number variable, 
address of data string to be output. 



ARG, 



ARG, 



ARG. 



ARG. 



6 
(optional) 



address of byte displacement variable. 

address of the byte-count variable. 

address of the options/status word. 

address of the end-action interrupt 
specification. 



where 



line is an integer voriable that identifies the 
terminal's line number (1 - Nmax). 

data indicates the starting location of the area 
from which data is to be output (word address 
resolution). 

displacement is an integer variable that gives the 

location of the first byte to be output, relative to 
the starting location (i.e., the number of bytes 
from the start of the data area). 

byte-count is an integer variable that specifies the 
number of bytes to be output. 

status is an integer variable that is to contain 
a code describing the options affecting execu- 
tion of the WrLte (tet prior to executing the 
call), and into which is stored a code giving 
the status of the request when returning to the 
calling program. ~' 

end-action (optional) indicates that on external 
interrupt is to be triggered at the completion of the 
output operation. The argument may be a constant 
or an integer variable having one of two forms: 

2Hoa, where aa Is the two-character label 
for the interrupt. 

3Znnn, where nnn is the hexadecimal address 
of the interrupt to be triggered. 

Each ARG has the standard calling sequence format de- 
scribed in the Extended FORTRAN IV Operations Reference 
Manual, No. 90 11 43. 

Execution of the CWRITE routine causes the following 
sequence of events: 

1. Validity checks are made on the arguments; if any are 
found to be invalid, control is returned to the calling 
program with the status returned in the location indi- 
cated (i.e., pointed to by the address of argument 5). 

2. The specified output string is moved from the user pro- 
gram area into temporary blocking buffers maintained 
by the COC routines. The characters are then trans- 
lated into external form as they are moved, and the 
buffers are chained together as they are allocated, with 
the first being linked to the output pointer UNKO for 
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the specified line. If output is currently in progress, 
the new output string will be chained to the data 
already queued for output (tee the description of 
Buffer Pool operations later in this Appendix). 

3. If output is not already active, the first character is 
prepared and sent to the COC. 

4. Control is returned to the calling program with an in- 
dication that the request was accepted and that output 
is in progress. The calling program may periodically 
monitor the progress of the output by execution of a 
CHECK command (i.e., CALL CHECK) for that line. 

The options/status variable may have the following legal 
values upon entry to the Write routine: 

Option Code Option 

Normal output operation. 

1 Abort input if operation is in pro- 
gress on the specified line, or 
awaiting completion of a currently 
active output. 

2 Abort output if operation is in pro- 
gress on the line (a carriage return 
and line feed will be sent to the 
terminal). 

Combinations of the above ore indicated by the arithmetic 
sum of the corresponding codes. 

The options/status word will have the following values 
upon return to the calling program: 

Status Code Meaning 

Normal Transfer; request accepted, 
data moved, and output in progress. 

1 Insufficient buffer space; request 
ignored. 

2 Invalid line number; request 

ignored. 



If interrupt label is given: 



Invalid line state; request ignored. 

Break signal has been received (for 
information only); request will be 
processed as specified. 



The presence of ARG in the assembly language calling 
sequence is optional, but the number of arguments con- 
tained in register 14 must be adjusted accordingly. The for- 
mat of the word containing the interrupt specification is as 
follows: 



I 2 J I 4 5 * 7 IS 9 10 111 12 13 U 15 1 U 1? II 19 1 30 21 22 2lh* 25 26 v\n 2* 3C j 



where 



If interrupt address is given: 






n r\ 


Hex interrupt loc. 


u u 


o i i id j * 1\k t t6 nl 12 13 u 


15116 17 II IT 


it !i U Hlfc U it 2>ltt i* Jo li 



C1C2 i> the Hollerith label assigned to the inter- 
rupt at SYSGEN time. 

A indicates a Hollerith space character. 



The priority of the end-action interrupt, and priority of any 
external interrupts associated with the user program, must 
be lower than the interrupt pair connected to the COC. 

The end-action interrupt must be connected and enabled by 
the user program (i. e. , through Monitor C A Ls or FORTRAN 
CONNECT statements). 



CALL CREAD (Aceeet taeei free. ■ TerwMl) 

This command is used to perform the following functions: 

1. Mark the input line status as active. 

2. Initialize the pointers and counters necessary to begin 
accepting and saving input from a specified line. 

3. Return control to the user. 

Input from a terminal may be enabled by execution of the 
following call: 

From FORTRAN programs, the call is 

CALL CREAD (line,bvte count,status[,end]) 

From assembly language programs, the call is 

U,14 3 (or 4). 

BAL,15 CREAD. 

ARGj address of line number variable. 

ARGj address of the byte count variable. 

ARG3 address of status word. 

ARG4 address of end-action interrupt specification, 
(optional) * 

where the arguments are all integer variables (or elements 
of integer arrays), with the following assignments: 

line is the communications line number. 

byte count is the maximum number of characters to 
accept with this call. 
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status is a variable into which will be stored a code 
giving the status of the request. 

end (optional) is the end-action interrupt specifi- 
cation, as described previously. 

When CREAD is executed, preparations are made to accept 
characters received from the specified input line. No tem- 
porary buffers are assigned until needed- Control is re- 
turned to the calling program (with the status of the request 
stored in the status variable), and the input operation may 
then proceed in parallel with program execution. 

Input will be terminated upon: 

1. Receipt of a character defined as an end of message 
code (including the Break signal). 

2. Receipt of the specified number of bytes. 

3. Execution of a Write, or Move Input command with 
the abort-input option specified. 

Note that this coll signals only that input is to be accepted, 
translated to internal form, and echoed if appropriate. It 
is the responsibility of the user program to effect any pre- 
liminary positioning of cursor, carriage, or paper, and 
clearing of display screen, etc. The Write call is adequate 
for this purpose. When an input message is complete, the 
user program must also issue a Move Input call to copy the 
message from the COC buffers into its own buffer space. 
The status argument has the following values when control 
is returned to the caller: 

Status Code Meaning 

Normal; request has been accepted 

and input may proceed. 

2 Invalid line number; request ignored. 

4 Invalid line state; request ignored. 

8 Break signal received; request 

ignored. 

CALL CMOVE (Move heel te ■ User Area) 

This command is used to copy the converted input charac- 
ters that have been received on a specified line into the 
specified user area. As the data is moved, the allocated 
buffers are released to the pool. When an input message 
has been received (whether complete or not), it may be 
moved from the COC Buffer Pool into the user's program 
area by execution of the following call: 

From FORTRAN programs, the call is 

CALL CMOVE (line,buffer,displacement,count, ■ 



From assembly language programs, the call is 
U, 14 5 



BAL, 15 

ARG, 

ARG 2 

ARG 3 

ARG 4 

ARG, 



CMOVE 

address of line number variable. 

address of user's buffer area. 

address of byte displacement variable. 

address of byte count varioble. 

address of options/status word. 



status) 



When this call is executed, the input received from the 
specified line is moved into the specified area. Control 
is returned to the calling program when: 

1. An error is dectected in the calling sequence. 

2. All received input has been moved. 

3. The specified number of bytes have been moved. 

Mien control is returned to the calling program, the fol- 
lowing modifications will have been made to the calling 
sequence: 

ARG- the byte displacement variable now points 

to the byte following the last byte moved 
(relative'to the user buffer address). 

ARG . the byte count variable contains a count 

of the input that has been moved, or that 
is yet to be moved (see description of 
"status", below). 

ARG. the options have been replaced by the 

status of the operation. 

The following options may be specified in the option/status 
variable: 

Option Code Meaning 

Normal operation. 

1 Terminate input if not already in- 
active (end -action interrupt will 
not be triggered). 

If input is still active, or if all data received has not yet 
been moved, the next Move Input operation will begin where 
the current operation stops. It is not necessary that input be 
complete when this call is executed, or thot^ption I be 
specified if input is active (see below). 

The status returned in the ARG5 location is as follows: 
Status Code Meaning 

Normal operation; all input moved 

(ARG4 location contains count of 
bytes actually moved). 
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Status Code Meaning 

1 Normal operation; not all input has 
been moved (ARG4 location con- 
tains a count of the number of bytes 
remaining to be moved). 

2 Invalid line number; request ignored. 

4 Input is active (for information on I/; 

does not affect this operation). 

8 Break signal has been received (for 

information only; does not affect 
this operation). 

Combinations of the above conditions are indicated by the 
arithmetic sum of their corresponding codes. 

Note that the Move Input routine is responsible only for 
moving an input message from the linked buffers into a 
single set of contiguous locations specified in the calling 
sequence. The user program is responsible for any editing 
that must be performed on the message. 

This call may be executed whether or notinput is still active 
on the line. When executed, the coll will move all char- 
acters that have been received "in the current "message" 
into the specified orea, up to the specified byte count. 
The temporary buffers are released as data is moved out of 
them, 
ingly as follows: 



CALL CHECK ( 



I/O 



The byte count variable (ARG.) is updated accord- 



1. If all characters so far received have been moved 
(status code = 0, 4, 8, or 12), the byte count variable 
will be set equal to the number of characters that were 
actually moved. 

2. If all characters have not been moved; that is, if the 
specified byte-count was less than the actual number 
of characters received (indicated by status code = 1,5, 
9, or 13), the byte count variable will be set equal to 
the number of received characters remoining in the 
COC buffers at the completion of this call. That is, 
upon return to the caller, byte count - actual number 
of characters received less the specified byte count. 



This command is used to determine the mode and status 
parameters associated with the specified line. It is used 
principally by programs that must monitor the progress of 
an I/O operation, rather than waiting to be interrupted 
upon completion. 

When a FORTRAN program must monitor the progress of an 
I/O operation or check the status of a line, it can issue 
the following call: 

CALL CHECK (line,mode,state,byte count) 

where the arguments are all integer variables (or elements 
of integer arrays), and have the following meanings: 

line contains the line number when the call is exe- 
cuted (i.e. , supplied by the user). 

mode will contain the current terminal operating 

mode upon return to the calling program (see 
below). 

state will contain the current line state upon re- 
turn to the calling program (see below). 

byte count will contain a count of the number of 
characters that have been received from the ter- 
minal (if any). 

The values returned in the mode and state argument loca- 
tions are identical to those contained in the corresponding 
entries of the MODE and STATE line control tables. These 
tables are described later in this Appendix. 

The assembly language calling sequence is not described 
since assembly language programs have easy, direct access 
to the Line Control tables. 



CALL CSTOP (Ttrarinte COC Activity) 

This command is used to terminate COC operation, halt 
input on the associated IOP channel, and disarm the 
associated external interrupts. Optionally, CSTOP may 
be colled on to terminate a single line without affecting 
operation of the others. 



The COC Line Tables are updated so that the next 
Move Input call for the line will begin where the pre- 
ceding call left off, regardless of whether the call was 
terminated because the specified byte count was satisfied 
or because all data was moved that was received up to 
that point. 

The line STATE table is also updated if STATE = 8 (input 
complete), and all characters have been moved. In this 
case, the input complete state is cleared, thus permitting 
subsequent CREAD end CWRITE calls to be accepted for the 
line. However, if not all data has been moved, the input- 
complete state will remain set, causing subsequent CREAD 
and CWRITE calls to be rejected. 



TURN OFF ALL LINES 

When all operations have been completed with COC equip- 
ment, the following call should be executed: 

From FORTRAN programs, the call is « 
CALL CSTOP 

From assembly language programs, the call is 
U,14 

BAL.15 CSTOP 
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This routine closes out all I/O activity in the following 
manner: 

1. Disarms the external interrupt pair assigned to the 
COC. 

2. Halt* input on the IOP channel assigned to the COC. 

3. Turns off all receivers. 

Control is then returned to the calling program, which 
is responsible for issuing the RL5 (release foreground 
task) CALL 

TURNS OFF SPECIFIC LINE 

If a specific line is to be turned off (i.e., the receiver 
turned off, and the Line STATE marked "out of service"), 
the following call should be executed: 

From FORTRAN programs, the call is 

CALL CSTOP (line-number) 

From assembly language programs, the call is 
U,14 1 

BAL,15 CSTOP 

ARG address of line number variable 



This call turns off only the specified receiver. No change 
is made to the IOPactivity or to the external interrupt pair 
connected to the COC. 



I/O INTERRUPT ROUTINES 

INPUT INTERRUPT PROCESSING 

The external interrupt pulse associated with COC input 
is generated each time the COC sends a character/line 
number pair to the IOP. The routine that services this 
interrupt performs the following functions: 

1. Fetches the pair from the IOP ring buffer. 

2. Identifies the source. 

3. Converts the character via the translation table 
assigned to the line. 

4. Examines the character to see if it requires special 
handling (e.g., end-of-message). 

5. Stores the character in the buffer assigned to the 
line, allocating on additional buffer when necessary. 



Marks the input complete if the specified number of 
characters have been received or if the received char- 
acter calls for end-of-message activation. 

Triggers the (optionally) specified external interrupt 
if end-of-message action is call id for. 

Checks for any additional character pairs (e. g. , from 
other lines) received during the time that the first pair 
was being processed. 

Exits. 



OUTPUT INTERRUPT PROCESSING 

COC generates an interrupt whenever a transmitter indi- 
cates it is ready to send another character. The routine that 
services this interrupt performs the following functions: 

1. Determines which line caused the interrupt. 

2. Determines whether any data is leftto sendon that line. 
If data is left, the next character is sent; if not, the 
transmitter is turned off, line status is updated, and the 
(optionally) specified end-action interrupt is triggered. 

3. Exits. 



END-ACTION PROCESSING 

Once started, an input or output operation will proceed in 
parallel with user program execution (by means of the COC ~ 
I/O interrupt routines). The user program may determine 
when an I/O operation is complete by periodically checking 
the line status. Alternatively, the user program may request 
that a specific external interrupt be triggered when an op- 
eration is complete. The COC CREAD and CWRITE com- 
mands permit this interrupt to be specified in the respective 
calling sequences, and a different interrupt may be speci- 
fied for each. Completion of output on a line occurs when 
the specified number of characters have been transmitted or 
when a "break" signal is received on the line (see below). 

Input completion on a line occurs under the following 
circumstances: 

1. When the byte count equals the specified maximum. 

2. When a "break" signal is received. 

3. When a character is received that is designated as an 
end-of-message or "activation" character m the trans- 
lation and/or special action tables. * 



SPECIAL ACTION PROCESSING 

Special actions are performed by the input interrupt rou- 
tine when certain control characters are received. After 
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translation, these characters are identified by their code 
value being in the range 



Table G-2. COC Parameters 



00 le - 3F 



16 



When a translated character is found to lie in this range, 
it is used as an index to a branch table. The entries in 
the table point to the individual subroutines that perform 
the indicated processing. About half of these special 
action codes ore assigned; the remainder ore available to 
users who wish to tailor the special action processing to 
suit their own needs. 

Special processing is also performed by the output routine, 
CW11TE. After a character is translated for output, it is 
tested for a value in the range 

F V FE ,6 

that has odd parity. As with the input interrupt routine, 
such a character is used as an index to a special action 
branch table- The special action characters ore defined 
toward the end of this Appendix along with the transla- 
tion tables. 

IREAK SI6NAL HANDLING 

The special line signal "break" (olso called "long space") 
is recognized and recorded regardless of line state or con- 
dition of transmission. The signal is transmitted from a 
terminal by depression of the BREAK key on a TTY. When 
a break signal is received, a bit in the line control table 
associated with the sending terminal is set. The condition 
of this bit is reported to the user in the status returned from 
an I/O command call (i.e., ofter initiation of a Read, 
Write, Move, or Status Check command), and the bit is 
cleared. During input from the terminal, the receipt of 
a break signal is also reported by placing the character 
EOT in the input buffer and setting the end -of -message or 
"activate" condition. If the program using the COC rou- 
tines wishes to examine the break condition without doing 
an I/O command, it may examine the bit directly (tee 
"Line Control Tables"). 

ESCAPE SEQUENCE PROCESSING 

The COC Support Package provides the capability to 
handle two-character escope sequences. That is, the user 
may cause special processing to occur when an© is re- 
ceived, followed by one of a user -designated set of "fol- 
lower" characters. The user must supply the set of routines 
to handle the escape sequences when the COC Support 
Package is assembled or loaded for his installation, (a de- 
scription of the required tables is given later in this chap- 
ter). Note that the routines will be entered with the COC 
input interrupt "high", hence the processing must be of 
very short duration. 



Label 


Directive 


Description 


COCNB 


EQU 


Number of 4-word buffers 
to be provided (see discus- 
sion in subsequent chapter). 


COCDN 


DATA 


Device number of attached 
COC OOP assignment). 


COCNO 


EQU 


COC number (DIOoddress). 


COCNL 


EQU 


Number of lines; 64 lines 
ore the maximum number 
that may be connected to 
a 7611 COC controller. * 


COCH 


EQU 


Location of input external 
interrupt (hexadecimal 
address). 


COCIO 


EQU 


Output external interrupt. 


The COC input/output commands (i.e., CALL 
CWRITE, etc. ) assume the lines to be numbered 
from 1 to COCNL. However, when assembly lan- 
guage coders are referring directly to the Line 
Control Tables, they must decrement the line num- 
ber before using as an index value. 



a whole. The parameters must be inserted i nto COC source 
deck (or included as updates to a compressed deck) by the user 
prior to assembly of the package for a given installation. 



UNE CONTROL TABLES 

The items listed in Table G-3 are maintained for each line 
supported by the COC. Each item is contained in o separate 
table of similar items indexed by the line number. All of 
the items are available to the user program loaded with the 
COC Support Package (i.e., each item is declared in a DEF 
directive). The user must declare each item to be accessed 
with a REF directive in the source code. 



In Table G-3 the given label corresponds to the first entry in 
the table (i.e., to the table entry that applies to line 1). 
The size given is for each entry in the table. The table 
contains as many entries as there are lines connected to the 
COC, as defined by the parameter COCNL. 



UNE STATE TAILE FORMAT 



COC DATABASE 

COC PARAMETERS 

The parameters itemized in Table G-2 define the configura- 
tion of the COC equipment and the COC Support Package as 



This table contains the current operational state of each 
line. The table is maintained dynamically for each line. 
The algebraic sum of any of the items below is valid except 
where the states represented by the sum are incompatible 
(e.g., a line cannot be accepting input and have input 
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Table G-3. Line Control Table Items 




label 


Size 


Contents 


Comments 


STATE 


Byte 


Line State 


Initialized by CSTART (described in 
Line State Table format below). 


MODE 


Byte 


Line/Terminal mode 


Initially supplied at assembly time. May 
be modified by Special Actions, by 
CSET routine or by user program (described 
in Terminal Mode Table format below). 


COCTERMN 


Byte 


Terminal type 


Initially supplied at assembly time. May 
be changed by CSET routine (described 
in Terminal Type Table below). 


COCOT 
COCIT 


Word 
Word 


Location of Output 
Conversion Table 

Location of Input 
Conversion Table 


* 


Supplied at assembly time and may be 
changed by user program (see below for 
standard table format). Note: these 
tables ore indexed by terminal type code 
rather than line number. 


UNKO 


Halfword 
Halfword 


Input buffer address' 
Output buffer oddress 




Relative address in buffer pool of first 
buffer in chain. Initialized and main- 
tained by COC support routines. 


COCBAI 
COCBAO 


Word 
Word 


Input character oddress \ 
Output character address J 


Byte address of next character to be 
transmitted or stored. Initialized and 
maintained by COC routines. 


COCMC 


Halfword 


Input character limit 


Number of characters to be accepted 
from terminal during current input. 


ARS 


Halfword 


Input character count 


Count of converted input characters con- 
tained in current message. 


COCENDI 
COCENDO 


Word 
Word 


Input end-action "\ 

Output interrupt- J 
Specification J 


Contains FPT pointed to by the CAL 
executed when end-action interrupt is 
triggered. Initialized and maintained 
by COC support routines. 


FLAG 


Byte 


Output sequence flog 


Initialized and maintained by COC sup- 
port routines. Controls sequence of out- 
put actions resulting from input. 



waiting; therefore, the code 5 is invalid). The codes as- 
signed are as follows: 

Decimal 

Code Mode of Terminal (One Byte Per Line) 

00 Inactive. 

1 Accepting input. 

2 Transmitting output. 

4 Input waiting; enable when output complete. 

8 Input complete. 

64 Error in message. 

128 Out of service (i.e., receiver is not on). 

TERMINAL MODE TABLE FORMAT 

This table contains the current operating mode of the ter- 
minal connected to each line. It is specified at assembly 



time, and is normally unchanged during operation except 
for the break flag and the escape-sequence flag. 



The codes assigned are as follows: 

Mode of Terminal (One Byte Per Line) 



Decimal 
Code 



1 Simplex — input. 

2 Simplex — output. 

3 Full-duplex (I.e. , independent simul- 
taneous I/O). 

4 Half-duplex. 
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Decimal 
Code 



where 



Mode ef Terming! (One Byte Per line) 



16 No-translate mode; neither input nor 

output characters ore to be translated. 

32 Break flog; long space has been 

received. 

64 Escape sequence (ESC character has 

been received; follower character is 
awaited. 

128 Echo flag (Half-duplex mode should 

also be set). 



TERMINAL TYPE TABLE (COCTERMN) 

This table contains a code byte that specifies, for each 
line, the type of terminal connected. This code is used 
as an index into the COCIT and COCOT tables when 
translating input and output characters respectively. If 
the user wants to add new terminal types or introduce 
different modes of handling a single terminal, he can 
accomplish this by assigning unused type codes, adding 
new translation tables, and expanding the COCOT and 
COCIT tables accordingly. 

The terminal type codes assigned are as follows: 



Code Terminol Type 

Teletype, model 33. 

1 Teletype, model 35. 

2 Teletype, model 37. 

BUFFER POOL 

Input from, and output to, user terminals is buffered in 
linked chains of four-word blocks maintained by the COC 
Support Package. Each buffer block has the format shown 
and consists of o halfword link, followed by (up to) 14 
data characters. 

Buffer Format 

word 
word 1 
word 2 
word 3 



Link 


C 1 


C 2 


C 3 


C 4 


C 5 


C 6 


C 7 


C 6 


C 9 


So 


C 11 


C 12 


C 13 


C 14 



link contains the address of the next buffer in the 
chain Relative to COCBUF, the buffer pool base 
address). 

C. Is the I/O message character . 



The number of buffers in the pool is specified by the user 
in the assembly time parameter, COCNB. The buffers are 
initially chained to the head of buffer pool, COCHPB. 
That is, the location COCHPB contains the relative address 
of the first available four-word buffer in the pool. The link 
halfword of this buffer contains the relative address of the 
next available buffer, and so on. The end of the chain is 
signified by a zero link in the last buffer of the chain. 

When a message is to be transmitted to a terminal, the mes- 
sage characters are translated to external code, and moved 
from the user area into the buffer pool. Buffers are re- 
moved from the ehoin of available buffers as needed, and 
assigned to the specific output line. The assigned buffers 
are linked together, and the relative address of the first 
buffer is stored in the LINKO Table in the entry position 
corresponding to the specified line number. After all char- 
acters contained in a buffer have been transmitted to the 
terminal, the buffer is released and linked back into the 
chain of available buffers. 

Buffering of input messages is handled in exactly the 
same way. The relative address of the first buffer in 
the chain for each terminal is stored in the UNKI Table. 
The buffer pool may also be used for other dynamic stor- 
age requirements. 



STANDARD INPUT/OUTPUT TRANSLATION TABLES 

Tables G-4andG-5 show the equivalence between the 
internal EBCDIC character set and the external codes 
generated/ recognized by the standard Xerox Teletype. 
In the present implementation, one input and one out- 
put translation table serve for the TTY. Variations in 
control character handling for the terminal is resolved 
within the supplied special action routines described in 
the following tables. 



INPUT SPECIAL ACTION TABLE 

Translated input characters with values in "the range 00-3F^ 
are handled by special routines that perforo the actions 
listed below in Table G -6. Users may add new entries to the 
table in the range 21 16~3Fjx (except for the parity error 
code, 38| ;. The input translation table must be modified 
(or another table supplied) to cause conversion of input 
characters into the new special character codes. The pa- 
rameter SPEC must also be altered to give the new limit to 
the Special Action Table. 
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Table G-4. Input Translation Table 








ASCII f 


EBCDIC 


ASCII* 


EBCDIC 


— 


Code 


Character 


Code 


Character 


Cede 


Character 


Code 


Characrer 





NULL 


00 




20 


blank 


40 


blank 




1 


SOH 


01 




21 


I 


5A 


j 




2 


STX 


02 




22 


■1 


7F 


II 




3 


ETX 


03 




23 


# 


7B 


I 




4 


EOT 


04 




24 


S 


5B 


S 




5 


ENQ 


09 




25 


% 


6C 


% 




6 


ACK 


06 




26 


& 


50 


& 




7 


BEL 


07 




27 


I 


7D 


I 




8 


BS 


06 




28 


( 


4D 


( 




9 


HT 


05 




29 


) 


5D 


) 




A 


NL 


15 




2A 


* 


5C 


* 




B 


VT 


0B 




2B 


+ 


4E 


4 




C 


FF 


OC 




2C 


i 


6B 


r 




D 


CR 


0D 




2D 


- 


60 


i 




E 


SO 


0E 




2E 


, 


4B 


. 




F 


SI 


OF 




2F 


/ 


61 


/ 




10 


DLE 


10 




30 





F0 







11 


DCl(XON) 


11 




31 


1 


Fl 


l 




12 


DC2(TAPE) 


12 




32 


2 


F2 


2 




13 


DC3(XOFF) 


13 




33 


3 


F3 


3 




14 


DC4(TAPE) 


14 




34 


4 


F4 


4 




15 


NAK 


0A 




35 


5 


F5 


5 




16 


SYN 


16 




36 


6 


F6 


6 




17 


ETB 


17 




37 


7 


F7 


7 




18 


CAN 


18 




38 


8 


F8 


8 




19 


EM 


19 




39 


9 


F9 


9 




1A 


SS 


1A 




3A 


: 


7A 


: 




IB 


ESC I 


IB 




3B 


9 


5E 


• 




1C 


FS 


IC 




3C 


< 


4C 


< 




ID 


GS 


ID 




3D 


= 


7E 


= 




IE 


RS 


IE 




3E 


> 


6E 


> 




IF 


US 


IF 




3F 


? 


6F 


? 




The ASCII code shown is th< 


e 7-bit code without the parity bit setting. The Input Trans la ti 


on Table, as contained in 




Hie program, is coded for eve 


m parity ASCII. All odd parity positions in the table contain « 


3 hexadecimal 38, indi- 




eating a parity error to the S 


jpport Package. 











Table G-5. Input Conversion 








ASCII 


EBCDIC 


ASCII 


EBCDIC 


Code 


Character 


Code 


Character 


Code 


Character 


Code 


Character 


40 


@ 


7C 


@ 


4A 


J 


Dl 


J 


41 


A 


CI 


A 


4B 


K 


D2 


K -l 


42 


B 


C2 


B 


4C 


L 


D3 


L ^ 


43 


C 


C3 


C 


4D 


M 


D4 


M 


44 


D 


C4 


D 


4E 


N 


D5 


N 


45 


E 


C5 


E 


4F 


O 


D6 


O 


46 


F 


C6 


F 


50 


P 


D7 


P 


47 


G 


C7 


G 


51 


Q 


D8 


Q 


48 


H 


C8 


H 


52 


R 


D9 


R 


49 


I 


C9 


I 


53 


S 


E2 


S 
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Table G-5. Input Conversion (cont. 








ASCII 


EBCDIC 


ASCII 


EBCDIC 


Code 


Character 


Code 


Character 


Code 


Character 


Code 


Character 


54 


T 


E3 


T 


67 


9 


87 


9 


55 


U 


E4 


U 


68 


h 


88 


h 


56 


V 


E5 


V 


69 


i 


89 


i 


57 


W 


E6 


w 


6A 


j 


91 


j 


58 


X 


E7 


X 


6B 


k 


92 


k 


59 


Y 


E8 


Y 


6C 


1 


93 


1 


5A 


Z 


E? 


z 


6D 


m 


94 


m 


5B 


[[ 


4F 


1 


6E 


n 


95 


n 


5C 




4A 


t 


6F 





96 


o 


5D 


]"-[ 


5F 




70 


P 


97 


P 


5E 


AA | 


6A 


s\ 


71 


q 


98 


q 


5F 


- . _ 


6D 


- 


72 


r 


99 


r 








I 






73 


s 


A2 


s 








mostTTYs 






74 
75 


t 

u 


A3 
A4 


t 
u 






XDS 7015 






76 
77 


V 

w 


A5 

A6 


V 

w 




68 ASCII 






78 


X 


A7 


X 


60 




7C 


@ 


79 


y 


A8 


y 


61 


a 


81 





7A 


z 


A9 


z 


62 


b 


82 


b 


7B 


{ 


42 


{ 


63 


c 


83 


c 


7C 


l_ 


5F 




64 


d 


84 


d 


7D 


f 


52 


T 


65 


e 


85 


e 


7E 


1 


4F 


i 


66 


f 


86 


f 


7F 


RUBOUT 


20 


i 



Table G-6. Special Action Toble 



Hex 

Value 


EBCDIC 

Name 


End-of- 
Message 


Special Actions 


00 


Null 


... 


Ignore. 


01 


SOH 


000 


Process normally. 


02 


STX 


— 


Process normally. 


03 


ETX 


— 


Process normally. 


04 


EOT 


— 


Ignore. 


05 


HT 


— 


Process normally. 


06 


ACK 


— 


Process normally. 


07 


BEL 


— 


Process normally. "^ 


08 


BS 


— 


Process normally. 


09 


ENQ 


— 


Process normally. 


0A 


NAK 


Yes 


Do input-complete processing and store EOT character in input buffer. 


0B 


VT 





Process normally. 
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Table G-©. Special Action Table (cont. ) 



Hex 
Value 


EBCDIC 

Name 

i 


End-of- 
Message 


Special Actions 


OC 


FF 





Process normally. 


OD 


CR 


Yes 


Echo IF, put X'OD' in input buffer, do input-complete processing. 


OE 


SO 





Process normally. 


OF 


SI 





Process normally. 


10 


DLE 





Process normally. 


11 


DC1 





Process normally. 


12 


DC2 





Process normally. 


13 


DC3 





Process normally. 


14 


DC4 





Process normally. 


15 


LF(NL) 


Yes 


Echo CR. Put X' 15' in buffer: do input-complete processing. 


16 


SYN 





Process normal ly. 


17 


ETB 


— 


Process normally. 


18 


CAN 





Delete line from input buffer. Send "back arrow" character then LF, CR. 


19 


EM 





Ptocess normally. 


1A 


SUB 





Process normally. 


IB 


ESC 





Set escape flag in MODE byte. Next input character will be treated as a 
follower in 2-character ESC sequence. 


1C 


FS 





Process normally. 


ID 


GS 





Process normally. 


IE 


RS 





Process normally. 


IF 


US 





Toggle Echo Mode; i.e. , turn off if now on, and vice versa. 


20 


DEL 





Erase last character from input buffer. Send "backslash" to TTY. - 


•38 


Parity error 





Send "'" to terminal. Put 2F in buffer. ' 


Note: All translated characters in the range 21w-3F]^ will be treated as a parity error. The lower limit is defined 
by the value of SPEC, which the user must change when adding to the Special Action Tables. 
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ESCAPE SEQUENCE TAKES 



ESCAPE Branch Table 



The COC Support Package includes the provision for 
handling 2-choracter ESCAPE sequence by use of routines 
supplied by the user. In such a sequence, the first of two 
characters is usually an ESC character. Alternatively, 
the user may supply a translation table that can cause any 
desired character to be translated into the ESC code 0B| o )> 
The second ESCAPE sequence is called a follower char- 
acter. The ESCAPE sequences are handled by two tables. 



FOLLOWER CHARACTER TABLE 

This table has one byte for each designated follower char- 
acter that contains the EBCDIC code for the character. 
The characters do not have to be stored in numeric 
sequence. 



Follower Character Table 



CESCNR 



N+1 



words 



N 


S 


C 2 


C 3 


C 4 


C 5 


C 6 


C 7 


'• 


• 


• 


• 



where 

N is the number of entries. 

C. is the EBCDIC code for one follower character. 



ESCAPE BRANCH TABLE 

This table has one word for each designated follower char- 
acter that contains a branch instruction to the routine that 
performs the desired functions. The position of an entry in 
the follower character table defines the position of the cor- 
responding branch instruction in the ESCAPE Branch Table. 



CESCNR 



N words 



Branch instruction to routine that 
handles follower character CI. 



Branch to routine that handles 
character C2. 



Branch to routine that handles 
charocter CN. 



The COC Support Pockoge is supplied with a set of dummy 
entries. The user may replace these, delete them, or 
expand the table, as necessary. 

OUTPUT CONVERSION (EBCDIC-USASCII) 

In Table G-7 all empty squares are coded Fl, and no char- 
acter is sent to the terminal. 

The upper character in each square represents the graphic(s) 
or the name of the character and the lower characters repre- 
sent the hexadecimal value of the character to be trans- 
mitted, minus the even-parity bit which is included in the 
supplied table. 

In special cases, the output conversion table contains 
an F, followed by the code number of a special handling 
routine. 

The usable F codes are those with bad parity (Fl, 2, 4, 7, 8, 
B, D, and E), since other F codes represent correct parity - 
checked characters. 

The assigned codes are: 

Fl Null. No character is placed in the 

output buffer. 

F2 CR and LF are placed in the buffer. 

F4 Output message is complete. 
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Tabic G-7. Output Conversion (EBCDIC - USASCII) 











SAott Significant Digits 


(of EBCDIC) 



















1 






4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


u 
5 

L» 

CO 
UJ 

u- 
J3. 

r 
"5> 

S 

c 

1 

1 

8 

c 

—J 





NUL 
00 


DLE 
10 






SP 
20 


& 

26 


2D 



















30 


1 


SOH 
01 


DC1 
11 










/ 
2F 




a 
61 


J 

6A 




\ 
5C 


A 
41 


J 
4A 




1 
31 


2 


STX 
02 


OC2 
12 














b 
62 


k 
6B 


% 
73 


I 
7B 


B 
42 


K 
4B 


S 
53 


2 
32 


3 


ETX 
03 


DC3 
13 














e 
63 


1 

6C 


t 
74 


f 

7D 


C 

43 


L 
4C 


T 
54 


3 

33 


4 


EOT 
04 


DC4 
14 














d 
64 


m 
6D 


u 
75 


U 
5B 


D 
44 


M 
4D 


U 
55 


4 
34 


5 


HT 

09 


NL 

LF 

0A 














e 
65 


n 
6E 


V 

76 


3! 

5D 


E 

45 


N 
4E 


V 
56 


5 
35 


6 


ACK 
06 


SYN 
16 














f 
66 


e 
6F 


w 
77 




F 
46 


O 

4F 


W 
57 


6 
36 


7 


BEL 
07 


ETB 
17 














S 
67 


P 
70 


X 

78 




G 

47 


P 
50 


X 
58 


7 
37 


8 


EOM 

BS 

08 


CAN 
16 














h 

68 


S 
71 


y 

79 




H 
48 


Q 
51 


Y 
59 


8 
38 


9 


ENQ 
05 


EM 
19 














i 
69 


r 
72 


z 
7A 




I 
49 


R 
52 


Z 
5A 


9 
39 


A 


NAK 
15 


SUB 
1A 






60 


21 


5E 


3A 


















B 


VT 
0B 


ESC 
IB 






2E 


$ 

24 


2C 


# 

23 


















C 


FF 
OC 


FS 
1C 






< 

3C 


* 

2A 


% 
25 


"a 
40 





















CR 
0D 


GS 

ID 






( 
28 


) 
29 


5E 


1 

27 


















E 


SO 
0E 


RS 
IE 






+ 
2B 


3B 


> 

3E 


3D 


















F 


SI 
OF 


US 
IF 






i: 

7C 


7E 


? 
3F 


M 

22 
















DEL 
7F 
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APPENDIX H. JOB MANAGEMENT 



CONCEPT OF I JOB 

A job is a col lection of rotated primary or secondary tasb 
wherein each tack is a body of procedural code, end the 
fob is the unit of work that is scheduled and initialized. 
Tasks are the subunits of work that are executed. Each job 
hat a system Job Control Block associated with it containing 
the data that is sharable or common across all tasks within 
the job. The Job Control Block resides in system space. 

Externally, a job is identified by a unique eight-character 
EBCDIC name. Internally, a job is identified by o unique 
number assigned by the system. There are two permanent 
jobs in CP-R; the CP-R job (which is the system itself), and 
the BKG (background) job. Additionally, there may be any 
number of foreground user jobs active at o given time, up to 
the SYSGEN set limit on the number of jobs allowed. 

The foreground programs of existing CP-R installations will 
run as tasks in the CP-R job. User jobs may contain any 
number of tasks. 

An important concept of a job in CP-R is that all resources, 
files, devices, or user defined resources are job-related 
and can be used by any task in the job . Devices may be 
designated at SYSGEN as sharable (across jobs) or allocat- 
able (nonsharable across jobs). 

To create a foreground job, the CP-R service SJOB is used. 
It is available either m a key-in or as a CAL. SJOB does 
not initiate ony task in the job; instead, it sets up job con- 
trols and builds a Job Control Block in the system area of 
memory. A RUN key-in or CAL, or an INIT key-in or CAL 
may be issued to start tasks in a job as follows: 

e A RUN key-in initiates a task in the CP-R job. 
e A RUN CAL initiates a task in the CP-R job. 



e An INIT key-in or CAL initiates a task in the spec- 
ified job. 

To terminate a foreground job, the CP-R service KJOB is 
used. KJOB is available as a key-in or as a CAL. It 
terminates the specified job by terminating every task 
within the job and deleting the job controls. 

To facilitate the initiation of tasks in a job, a job level table 
called the Job Program Table (JPT) is maintained in the Job 
Control Block. The JPT allows the user to specify the name 
of a load module tobe used for execution of a task. It is 
composedofdoubleword pairs of EBCDIC task name/load 
module name equivalences. Table look-up on the task name 
determines which load module will be .loaded as the task 
specified on a RUN or INIT request. JPT entries are made 
via the SETNAME system function call. SETNAME speci- 
fies a task name/load module name pair that are entered 
in the JPTof the specified job. Task initiation uses the JPT 
to determine which load module to load. If no JPTentry is 
found for the specified task name, the task name is used for 
the load module name, SETNAME may also be used to de- 
lete previously established JPT entries. 

CP-R inter job communication may occur either because it is 
not prevented, such as in the unrestricted use of memory by 
foreground tasks, or because system services are invoked. 
Permanent disk files may be shared by tasks regardless 
of job designation. Access to disk files is controlled via 
Open/Close requests. Public libraries are shared between 
all jobs. Foreground mailboxes may be used by foreground 
tasks for inter job communication. 

CP-R services SIGNAL, POLL, and POST may be used 
to communicate between jobs. Services ENQUEUE and 
DEQUEUE may be used for system independent resource 
management between jobs. 
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APPENDIX L TASK MANAGEMENT 



Each centrally or directly connected interrupt in CP-R 
defines a new task. Ecich program loaded into memory by 
the Foreground or Background Loader defines a load mod- 
ule. In the case of foreground, a load module may consist 
of one or more tasks. The background load module consists 
of one task that runs when no hardware interrupts are 
active. Each secondary load module also defines a single 
task entry. Two additional permanent tasks exist, which 
are the CP-R Control Tasks. 

The background activity is controlled by the JCP and runs 
a sequential stream of job steps within jobs. 

Foreground primary and secondary activity is controlled 
by CP-R task management as directed by user service calls, 
key-ins, and control commands. 

Upon receiving a request to run a primary load module, the 
Foreground Loader portion of the Control Task becomes 
active and loads the program into memory when the required 
core is available. The initialization required by the pri- 
mary load module can be accomplished by operations per- 
formed when the program is given control at its entry point. 
This code runs as an extension of the CP-R Control Task 
and therefore blocks all Control Task functions until it 
EXITs or TERMs. 



IMMEDIATE 

All services are classified as immediate if they are fully 
satisfied by the time CP-R returns control to the user and 
require no waits or delays for an event to occur. The ser- 
vices that ore immediate are as follows: 



DEVICE 


JTRAP 


DEQUEUE 


PC 


STATUS 


DISARM 


DEBUG 


ERASE 


DISCONNECT 


ERRSEND 


RELPAGE 


SLAVE 


MEDIA 


DISABLE 


TEST 


POST 


ARM 


EXTM 


SCHED 


CONNECT 


SETNAME 


INT 


TEXIT 


ALARM 


TRIGGER 


TRTY 


RECALARM 


ENABLE 


EXIT 


CALRTN 


MASTER 


ABORT 


GETTJME 


RLS 


TRTN 


SJOB 


STOPIO 


TERM 


KJOB 


STARTIO 


EXDA 


STOP 


lOEX 


START 


DEACTIVATE 


TIME 


MODIFY 


UNLOCK 


TRAP 


LOCK 





The tasks connected to interrupts in the foreground program 
become active when the interrupt becomes active and re- 
main active until they EXIT or TERM. The interrupt can 
be triggered from external sources as an end-action to a 
previously requested service or by a user TRIGGER CAL. 

Secondary tasks are created by use of the INIT service call. 
Upon receipt of the service call, a task and load module 
entry is created and the secondary task is loaded at the dis- 
patcher level and software level specified in the INIT ser- 
vice call. Unlike primary load modules, secondary load 
modules are initialized at their own priority and therefore 
many such initializations may occur concurrently. There is 
thus no reason for special initialization code as is required 
for primary load modules. 



DISCONNECTMG PRIMARY TASKS FROM INTERRUPTS 



SYNCHRONOUS 

Some services involve a wait while processing and become 
synchronous either implicitly (a wait option was not pro- 
vided) or explicitly (user selected waif option in his FPT). 
These services initiate the oction, wait for it to complete, 
execute retry paths as required, and finally return to the 
caller after posting the successful or unsuccessful type com- 
pletion data. Services that are implicitly synchronous are 
as follows: 



DEVICE 


WAIT 


ALLOT 


OPEN 


WAITALL 


DELETE 


CLOSE 


WAITANY 


TRUNCATE 


CORRES 


GETPAGE 


PREFMODE 


ACTIVATE 


TEXT 


JOB 



The user can disconnect a primary task from an interrupt 
through the use of a DISCONNECT function call. The in- 
terrupt will be left disarmed and available for connection 
Id another program prior to the termination of the currently 
connected program. 



EVENT MANAGEMENT 

Services requested by tasks via CALs are classified as im- 
mediate, synchronous, or asynchronous, as described below. 



Services that may be explicitly made synchronous by speci- 
fying a wait option are as follows: 



REW 


CHECK (no busy address) 


WEOF 


PRINT 


UNLOAD 


TYPE 


READ 


SEGLOAD 


WRITE 


STIMER 


PFIL 


DELFPT (no busy address) 


PREC 


STDLB 


ENQUEUE 


POLL 


INIT 


SIGNAL 
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ASYNCHRONOUS 

Some services involve a wait while processing and become 
asynchronous when the user specifies 'no-wait' in his FPT. 

Upon execution of the service call, CP-R initiates the 
service and returns to the caller. Services that may be 
requested asynchronously are as follows: 



REW 


CHECK (with busy address) 


WEOF 


PRINT 


UNLOAD 


TYPE 


READ 


SEGLOAD 


WRITE 


STIMER 


PFIL 


DEL FPT (with busy address) 


PREC 


STDLB 


ENQUEUE 


POLL 


IN IT 


SIGNAL 



In order to control asynchronous and synchronous services, 
CP-R creates temporary Event Control Blocks (ECBs) in which 
it retains information such as type of service, priority of the 
caller, calling program's identification, caller's FPTorDCB 
address from the original service request, end-action re- 
quested, and type completion when the service is done. 
These ECBs are automatically deleted by CP-R prior to re- 
turning to the calling task if a synchronous service request 
was made. If the request was asynchronous, the ECB will 
not be deleted until a service checking call is issued by 
the user, resulting in the posting of type completion and 
exit to the user via the normal, error, or abnormal return. 



Therefore, when an asynchronous service request has been 
■node, the user must ensure that this temporary control 
information is deleted by issuing a CHECK, DELFPT, 
WAITANY, WAITALL, or TEST service call until the FPT/ 
DCB is posted as complete. 



Some service calls have individual characteristics that vary 
from those described above. These are as follows: 



RUN 

The RUN service call is implicitly asynchronous in that the 
RUN request is initiated when the RUN call is executed but 
program loading is actually performed at some later time by 
the Foreground Loader. The foreground user can optionally 
request status posting into o signal odd r ess and/or an end- 
action interrupt. No event controls are created and CHECK 
class calls do not oddress themselves to previously requested 
RUNS. 



SEGLOAD 

A SEGLOAD service call from the background has implicit 
wait regardless of FPT options. A SEGLOAD service call 
from the foreground can be with or without wait. A CHECK 
on a SEGLOAD call that contains the OVLOAD Table ad- 
dress corresponding to the read FPT for the segment loaded 
may be used. If no check is issued, the system will auto- 
matically delete the event controls for the user. 
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APPENDIX J. RESOURCE MANAGEMENT 



All CP-R resources are job-reloted and can be used by 
any task in the job, within the restrictions governing the 
specific type of resource. Resources Include files and 
devices. 



CP-Rallowsthe user to control his file and device resources 
by not placing unnecessary system use restrictions on them 
and by providing the system services with which the user 
may superimpose his own controls. 



Permanent files may be shared by tasks from different jobs 
without restriction. Within a job the only restriction is 
that a user cannot read sequentially from a file that was 
previously OPEN. 



DCB-file correspondence for tasks in foreground jobs can 
be made via load time ASSIGNS, user DCB manipulation, 
and the CP-R services DEVICE and STDLB. 



The background job may use all the CP-R services for file 
and device management. Background may be excluded from 
use of specific devices dedicated to foreground use. The 
background job takes the lowest priority in the system but 
may not be preempted from use of a device for which it has 
obtained exclusive use. 

A background job may specify DCB-file and DCB-device 
correspondence via run-time ASSIGN, load- time ASSIGN, 
user manipulation of DCBs, and CP-R services DEVICE and 
STDLB. 

The STDLB system function call allows tasks to acquire or 
release exclusive use of an allocatable device in addition 
to STDLB operational label assignment. The STDLB service 
is provided to acquire, release, or reassign a device or file 
and to reassign an operational label . STDLB operates on 
the operational label table in the Job Control Block (JCB) 
of the job containing the requesting task. If specified and* 
if possible, it also reserves the device for the job. 



File service routines are provided to dynamically define 
(ALLOT), delete (DELETE), or truncate (TRUNCATE) per- 
manent disk files. Service calls are provided to dy- 
namically modify DCB parameters (DEVICE), inspect DCB 
parameters (DEVICE), acquire or release a file via its op- 
erational label, and alter an operational label assignment 
(STDLB). These service routines provide job-level file re- 
source management under user control. 

In CP-R, devices may be acquired for a job via explicit 
OPEN requests, implicit OPENs resulting from READ re- 
quests, or explicit STDLB service requests. As for files, 
DCB-device correspondence can be made via load time 
ASSIGNS, user DCB manipulations, and DEVICE and STDLB 
services. 



Device use is specified at SYSGEN and via a STOPIO ser- 
vice call as available for foreground, all callers, no callers 
(in which case user requests are queued by the system), and 
diagnostic (down). The device is further designated at 
SYSGEN as shamble or for exclusive use only. An OPEN 
request on a device designated for exclusive use will result 
in the device being acquired by the job for exclusive use 
if the device has not already been acquired by a previous 
job. 



Dynamic device assignment may be made via the service 
functions DEVICE and STDLB. 



Memory is considered a resource and is managed for tasks 
in foreground jobs and the background job . Segments con- 
taining reentrant code (such as Public Libraries) may be 
considered as resources and shared by foreground and back- 
ground tasks. 



At job creation, all jobs get the CP-R job (system permanent 
values) operational label assignments. Tasks in the job may 
use STDLB calls to alter these assignments for their own job 
only. These alterations apply for the duration of the job 
for all tasks in the job or until a task in the job issues an- 
other STDLB request. STDLB calls may be used as often as 
required by the job. 



The I STDLB control command applies to background use only 
and is processed by the JCP. 



The STDLB key-in is accepted by the key-in processor and 
processed by the STDLB CAL. A STDLB request generated 
by a key-in or by a task in the CP-R job is recognized by 
the STDLB CAL. When so recognized, the CAL processor 
changes the operational label assignment in the CP-R job, 
and changes the operational label assignment in all jobs 
currently using the CP-R default values. 

The STDLB CAL processor uses standard OPEN/CLOSE calls 
to set up assignments for files and sharable devices and to 
reserve exclusive devices for STDLB requests. 

CLOSE checks the operational label assignments in a re- 
questing job to ensure that a file or device is not released 
prematurely. A STDLB request to release a file*or device 
will alter the job entry before requesting a close 1 so that 
CLOSE will not find the file or device and will thus allow 
the resource to be released . 

The use of STDLB does not preclude use of OPEN/CLOSE 
by tasks, but provides assurance that if STDLB is used to 
acquire a resource for a job, either a STDLB is required 
to release the resource or it will not be released until job 
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termination . If STOLB ware not uMti to ocquire a resource 
for a job, then OPEN/CLOSE pairs would acquire/release 
the resource as available. 

File or device acquisition is accomplished by specifying the 
operational label and resource name (operational label, nu- 
meric zero, disk file name, deviee name) in the FPT. If 
the enqueue option was not specified, the resource will be 
acquired exclusively for the job if the resource Is "alloca- 
table", and shared by the job if the resource Is "sharable". 
An error completion code will be returned if it was not 
possible to acquire the resource. If the enqueue option was 



specified and the resource was not available, STDLB will 
retum to the user with the FPT BUSY bit set. In any case, 
the user must CHECK at some point to obtain completion 
status and force completion of the STDLB request. The 
standard rules for using CHECK apply. If o time was speci- 
fied in the FPT, the enqueue will be timed out; otherwise, 
no time-out will be performed and the request will not dis- 
appear unless a specific delete FPT request is made, the job 
terminates, or the resource is acquired. 

Release of a resource (one previously acquired by an STDLB 
call) occurs when the release option is specified. 



Appendix J 317 



APPENDIX K. PERIODIC SCHEDULING 



The periodic scheduling feature sf CP-R allows the user to 
specify a task which CP-R should initialize at user requested 
intervals. The user may establish such a request via the 
monitor service call or key-in. The request may be deleted 
using either service call or key-in. 

The periodic scheduler executes as a control task overlay 
and keeps its requests for initialization in the file SCHED 
in the SP area. The SCHED file is automatically alloted 
as an extensible file, when the first request for the periodic 
services is received. The user may override the automatic 
allotment by alloting the file before executing a periodic 
scheduler request. This allows the user to set an upper 
limit on the number of such requests outstanding. The 
SCHED file must be unblocked and hove a granule size 
of 256 words. Each granule holds up to 16 periodic sched- 
uler requests. 



The start time specified by the request will be rounded up 
to the next five second start time. Any interval specifica- 
tion will be rounded up to the next five second quantity. 
if the period specified proves to be less than the time re- 
quired for task execution, the number of cycles missed will 
be logged when the task is next initialized. 



The entry will be automatically deleted for anyerror received 
on the INIT. Exceptions ore if the task already has been 
INITed or if there is not enough table space. Requests with 
zero intervals will, of course, be deleted upon their singular 
INIT. 

A full description of oil variations of periodic scheduling 
exists under the SCHED monitor service call pnd SCHED 
key-in. 
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APPENDIX L ERROR LOGGING 



Error logging is provided as an CP-R option that may be 
invoked by using the ERRORLOG option on the MONITOR 
card during SYSGEN. 

As error and other log records are produced, temporary 
space is obtained for each record and the record filled in. 
Fbinters to each record are pushed into a stack and a count 
of the records incremented. The Control Task is then trig- 
gered to copy the records out to the ER op label. As the 
records are written out, the temporary space is returned to 
the common pool and the pointer is pulled from the stack. 
The records are 16 words long and may be written to a 
blocked or unblocked file, a magnetic tape, a card punch, 
or NULL, depending upon the ER op label assignment. 

If a log record is lost for any reason (i.e., no more room 
in the stock or no temporary space available), a count of 
lost logs will be incremented. 

The following error messages may be output by the Control 
Task during error logging: 

1 1 ERROR LOG FILE IS FULL 

I (UNRECOVERABLE ERROR ON ERROR LOG FILE 

I J UNABLE TO OPEN ERROR LOG FILE 

The number of I/O accesses, errors, the error rate by de- 
vice and the error tog counters moy be interrogated using 
the ESUM key-in (see Chapter 3). 



Error logging moy be turned off or on by the use of the 
following key-in: 



ELOG 



IS> 



Turning error logging off this way saves the majority of the 
execution time overhead associated with error logging but 
retains the maintenance of I/O statistics displayed by ESUM 
key-in. 

Text entries moy be put in the error log by using the 
ERRSEND key-in. 

Date/time key-in causes a series of startup, time stamp and 
configuration entries to be placed in the error log. 

If the error log is maintained on a file, it can be emptied 
and reinitialized with the time-^tomp and configuration 
entries by the following key- in: 

ELOG PURGE 

The purge will not take effect if the error log file is being 
used by any process other than error logging (such as ELLA, 
the Error Log Listing and Analysis program) at the time of 
the command. 
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APPENDIX M. SYSTEM ALARM PROCEDURES 



CP-R has a nu~nber of software checks that will indicate 
when an irrecoverable software or hardware fault has oc- 
curred. When such a fault is detected, an immediate and 
controlled system shutdown will be forced and the sequence 
of events listed below will follow: 

]. All inhibits will be set and all registers saved. 



A 1 -second wait will occur, during which a descend- 
ing tone will be output on the console speaker to per- 
mit current I/O to run down. 



3. All I/O devices will be HlOed through their primary 
device address. 



The 1-Khz alarm will be turned on. 



5. An alarm message in the form of "1 1 ALARM text" will 
be output on OC. 



6. If there is a CK area present in the system, memory will 
be saved on the CK area until either the end of mem- 
ory or end of area is reached. 1024-byte blocks will 
be used and a "CORE SAVED" message will be output 
on OC when end of memory or CK area is reached. 



7. The alarm will be turned OFF. 



8. One of three final actions will then be done based on 
the content of the system alarm receiver control word 
ALARMREC. 

a. The system will hang in a one instruction loop 
with all interrupts inhibited if the ALARMREC 
cell is zero. This is the normal default case. 

b. The system will reboot from the system disk if the 
ALARMREC cell is negative. This may be set as 
a default by use of the REBOOT option on the 
:MONITOR card during SYSGEN. It may also 
be set by a foreground user using the ALARMREC 
CAL. 

c. The system will branch to a user alarm receiver lo- 
cated in real memory. The system itate will be as 
if a system reset had occurred and the user's alarm 
receiver will be entered in Master-unmapped mode. 
All interrupts will be disarmed and disabled and 
all inhibits will be set. All I/O will have been 
stopped. No CALs should be done in the user 
alarm receiver. 

This option is selected by a user task setting 
ALARMREC to the address of his alarm receiver 
by use of the ALARMREC CAL. 

The core saved on the CK area may be interrogated by using 
the CKD, CRS, or CRD key-ins when the system is brought 
back up (see Chapter 3). 

Note: The first ROLL-OUT operation will overwrite the 
CK area and the core image will be destroyed. 
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APPENDIX N. CP-R SERVICE CALLS 



Requests for CP-R services are made via CAL1 instructions 
that cause a Monitor trap, thus allowing CP-R to perform 
the requested service*. CAL2, 3, and 4 may be used sim- 
ilarly for user-dependent services. 

CAL1 instructions may be immediate, as in the form 

CALl,x value 



Refer to the inside front cover of this manual for a list of 
the available CP-R services. 



or contain an FPT (Function Parameter Table) address, as 
in the form 

CAL! , x [•] address[,»ndex] 

An FPT contains one or more words with parameters to fur- 
ther define the exact CP-R function to be performed. 

CALI calls may be executed out of the registers, via the 
EXU instruction, or cascading EXU instructions. The FPT 
also may reside in the registers, as may any directly or in- 
directly referenced parameter within the FPT (unless other- 
wise specified in the CAL description). 
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APPENDIX 0. ERROR AND ABNORMAL CODES 



TYPE COMPLETIONS (TYC) 

A Type Completion Code (TYC) U on indicator that shows 
the type of completion for a service call. The routine that 
processes the service request or an associated routine de- 
tects normal or abnormal completion of the service and 
notifies the user by posting the TYC in the TYC field of 
the user's FPT or DCB. The Type Completion Codes are 
listed in Table O-l. 



ERROR CODES 

An error code is returned to the user via the provided error 
or abnormal return address if normal completion of the re- 
quested service is not possible. At entry to the user's 
Error/Abnormal routine, the error code is contained in 
byte of register 10. For I/O requests, the DCB address 
is contained in the address field (low order 17 bits) of reg- 
ister 10. For non-I/O requests, the FPT address is contained 
in the address field of register 10. Register 8 contains the 
address of the location following the CAL1 instruction. The 
previous contents of registers 6 and 10 are tost. The Error 
Codes are listed in Table 0-2. 



provided and control it returned to the user at the in- 
struction following the CALL 

2. If the Abort Override bit is not set, control will be 
turned over to the TRAP handler (a pseudotrap, TRAP50, 
occurs). The user's trap handler will be entered if 
present; otherwise, the user will be aborted. 

If an abnormal condition is detected in the servicing of 
a request and an abnormal return address has not been 
provided, registers 8 and 10 will not be altered and the 
CAL processor will return to the instruction following 
the CALL In this case the contents of the TYC field 
will be unpredictable. 



Note that in order to handle an FPT abnormal condition 
the user's FPT must contain an abnormal return address; to 
handle an FPT error condition the user's FPT must contain an 
error return address. Similorly, if the user wishes to handle 
DCB abnormal conditions, the DCB must contain an abnormal 
return address; in order to handle DCB error conditions, the 
DCB must contain an error return oddress. 



If an error condition is detected in the servicing of a re- 
quest and the user has not provided an error return address 
in the request FPT/DCB, processing will terminate and one 
of the following will occur: 

1. If the Abort Override bit is set in the FPT, register 8 
and 10 are modified as if an error return address was 



Abnormal conditions (DCB or FPT) apply only to I/O service 
requests. 



Table 0-3 illustrates the settings of TYC, BUSY, and R10 
for various types of calls and error conditions. 



Table O-L Type Completion Codes 



Service 
Cotegory 


TYC (Hex) 


Description 


R10, byte Settings 
From Table N-2 


All 


00 


If Busy = 0, immediate error occurred on on I/O request. 


One of the DCB error 
or abnormal codes. 






If Busy = 1, service is in process. 


Unchanged 


All 


01 


Normal completion. 


Unchanged 


VO 


02 


Lost data (user 's buffer was shorter than data record read). 


07 


I/O 


03 


Beginning of tape. 


ID 


VO 


04 


Foreground I/O request would have required operator 
intervention to complete. Instead, the request was 
errored. 


30 


]/o 


05 


Physical end of tape, area, or file space. 


1C 


I/O 


06 


End of data (1EOD). 


05 



322 Appendix O 



Table O-l. Type Completion Codes (eont. ) 



Service 
Citegory 


TYC (Hex) 


Description 


R10, byre Settings 
From Table N-2 


I/O 


07 


End of file (tape mark on tape). 


06 


Vo 


08 


Irrecoverable I/O error. 


41 


Vo 


09 


Reserved. 


- 


Vo 


0A 


Write protection violation. 


42 


Vo 


OB-OF 


Reserved. 


- 


Vo 


10 


Line printer loss of position. 


4B 


Vo 


11 


Inconsistent status or position detected during VO. 


4C 


Vo 


12 


Request aborted. 


4D 


Vo 


13-18 


Reserved. 


- 


Vo 


19-60 


Reserved. 


- 


Non-l/O 


61 -FF 


See Table N-2 for meanings. 


Same as TYC 



Table 0-2. Monitor Error and Abnormal Codes 



Service 
Category 


RIO Hex 
Code 


Description 


Return Address 


I/O 


01 


A DCB has been opened with incorrect parameters. 


DCB Abnormal 


Vo 


03 


The assigned disk fi le does not exist or the assigned device 
is down or unavailable. 


DCB Abnormal 


Vo 


05 


An end-of-data or and-of-file (tapemark) has been 
encountered (IEOD). 


FPT Abnormal 


Vo 


06 


The end of input has been encountered (i.e. , a control 
command has been read on the C device). 


FPT Abnormal 


Vo 


07 


The buffer specified is smaller than the data read. 


FPT Abnormal 


Vo 


0A 


An attempt has been made to close a DCB that is already 
closed. 


DCB Abnormal 


Vo 


1C 


The end-of-tope has been encountered. 


FPT Abnormal 


Vo 


ID 


The beginning-of-tape has been encountered. 


FPT Abnormal 

-* 


Vo 


2E 


An attempt has been made to open a DCB that is already 
open. 


DCB Abnormal 


Vo 


2F 


DED DPndd, R key-in in effect. 


DCB Abnormal 


Vo 


30 


The request resulted in a condition which the operator can 
correct if the proper message has been output on OC . 


FPT Abnormal 
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Table 0-2. Monitor Error and Abnormal Codes (cont.) 



Sorvice 
Category 


RIO Hex 
Code 


Description 


Return address 


I'O 


40 


A request has been made to read an output device. 


DCB Error 


I/O 


41 


An irrecoverable error has occurred. 


FPT Error 


I/O 


42 


A RAD write protection violation has occurred. 


FPT Error 


I/O 


44 


A request has been mode to write on an input device. 


DCB Error 


I/O 


46 


The DCB contains insufficient information to open a 
closed DCB on a read operation. 


DCB Error 


1 o 


47 


The DCB contains insufficient information lo open o 
closed DC Bon a write operation. 


DCB Error 


I'O 


48 


A non-real-time request was made on a busy DCB. 


DCB Error ' 


I/O 


4A 


The user buffer address or byte count is invalid. 


DCB Error 


I'O 


4B 


Hard copy or format error on BDP Printer. Paper position 
is indeterminate. 


FPT Error 


I/O 


4C 


Inconsistent status or position detected during I/O. 


FPT Error 


I/O 


4D 


The request has been aborted by the system or the user. 


FPT Error 


I/O 


4E 


An error has occurred from which the cooperative 
cannot recover. 


FPT Error 


^0 


54 


More than one attempt has been made to read a control 
message from the C device through the some DCB. 


DCB Error 


I/O 


55 


The DCB cannot be opened because the RFT is full, the RAD 
is down, or no buffer could be found for the directory search. 


DCB Error 


I/O 


5& 


A foreground request was made to the C device. 


DCB Error 


I/O 


59 


DCB has changed since being OPENed. 


DCB Error 


I/O 


5B 


Illegal job identification for a RAD file close request. 


DCB Error 


I/O 


60 


Input request on a shared device or file. 


DCB Error 


All 


61 


Interrupt Label is undefined. Interrupt Address is outside 
valid range or is not valid for call. 


FPT Error 


All 


62 


Task Nome illegal or invalid. 


FPT Error 


All 


63 


Job Name illegal or invalid. 


FPT Error 


All 


64 


End Action used is not legal for caller. 


FPT Error A. 


All 


65 


Conflict with lower priority task. 


FPT Error 


All 


66 


Space was not available in a table whose size was 
set at SYSGEN in TSPACE. 


FPT Error 


All 


67 


The operation timed-out (non-i/O time-out). 


FPT Error 
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Table 0-2. Monitor Error and Abnormal Codas (cant.) 



Service 
Category 


RIO Hex 
Code 


Description 


Return Address 


All 


68 


The responsible task terminated without completing a 
service requested. 


FPT Error 


All 


69 


A service request was deleted by the responsible task or 
a third party. 


FPT Error 


All 


6A 


The service requested is not valid for the caller because 
of his Job/Task Type. 


FPT Error 


All 


6B 


Wait not legal for primary task. 


FPT Error 


All 


6C 


Clock value missing or invalid. 


FPT Error 


All 


6D 


Signalling task terminated. 


FPT Error 


All 


6E 


Signalling task aborted. 


FPT Error 


All 


6F 


The responsible task terminated abnormally without 
completing the service. 


FPT Error 


All 


70 


Illegal or invalid RAD area name. 


FPT Error 


All 


71 


The file name is illegal or undefined. 


FPT Error 


All 


72 


Space was not available on disk. 


FPT Error 


All 


73 


Debug initialization while in DEBUG. 


FPT Error 


All 


74 


Oplabel invalid. 


FPT Error 


All 


75 


Debug request while terming. 


FPT Error 


All 


76 


Resource invalid. 


FPT Error 


All 


77 


Illegal file format. 


FPT Error 


All 


78 


Two tasks attempting to act on one item 
simultaneously. 


FPT Error 


All 


79 


Illegal combination of parameters. 


FPT Error 


Symbionts 


7A 


Illegal JOB card format or parameter encountered . 
by symbionts. 


FPT Error 


SJOB 


7B 


Illegal account/user name. 


FPT Error 


VO 


7C 


File directory reentrancy (used internally). 


Not Applicable 


ASSIGN 


7D 


DCB is too small for assignment requested. 


FPT^rror 


All 


82 


Task already idle on stop request. 


* 

FPT Error 


All 


83 


Immediate service request cannot be satisfied. 


FPT Error 


All 


84 


Resource never acquired originally on DEQ. 


FPT Error 


All 


86 


Identification not valid. 


FPT Error 
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Table Q-2 t Monitor Error and Abnormal Codes (cant. ) 



Service 


RIO Hex 






Category 


Code 


Description 


Return Address 


All 


8A 


CAL already connected. 


FPT Error 


All 


8B 


Address parameter not valid. 


FPT Error 


All 


8C 


Invalid status flags. 


FPT Error 


All 


80 


Data area Invalid. 


FPT Error 


All 


8E 


List task is not active. 


FPT Error 


All 


90 


Pages not in a defined partition. 


FPT Error 


All 


91 


Pages not in a preferred partition. 


FPT Error 


All 


92 


VPNL/VPNH not in same preferred partition or segment. 


FPT Error 


All 


93 


Preferred page allocation conflict. 


FPT Error 


All 


94 







All 


95 


Preferred page not assigned to requestor. 


FPT Error 


All 


96 


frivol id segment number. 


FPT Error 


All 


97 


VPNL/VPNH error. 


FPT Error 


All 


98 


Page allocation conflict. 


FPT Error 


All 


99 


On-going I/O in one or more pages. 


FPT Error 


All 


9A 


Inactive segment is not in "defined" state. 


FPT Error 


All 


9B 


Operation on inactive segment. 


FPT Error 


All 


9C 


Unlock on segment that is not locked. 


FPT Error 


All 


9D 


Erase on segment that is not active. 


FPT Error 


All 


9E 


Lock on segment that is already locked. 


FPT Error 


All 


9F 


CAL or FPT address reference to inactive segment. 


FPT Error 


AM 


AO 


Activate to active segment. 


FPT Error 


All 


Al 


A read error has occurred. 


FPT Error 


All 


A2 


Segment length equals zero. 


FPT Error 


All 


A3 


Simplified Memory Management Memory size exceeded. 


FPT Error 
FPT Error 


All 


A4 


Real memory not available. 


All 


AF 


Memory management control error. 


FPT Error 


All 


BO 


Task being initiated is a PUBLIB. 


FPT Error 


All 


Bl 


Secondary task being initiated is primary, or vice versa. 


FPT Error 
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Table 0-2. Monitor Error and Abnormal Codes (con».) 



Service 
Category 


RIO Hex 

Code 


——————————————— 

Description 


Return Address 




All 


B2 


Secondary program exceeds memory limits. 


FPT Error 




All 


B3 


Too many segments for secondary task. 


FPT Error 




All 


84 


Load module being initiated uses a PUBLIB that names o 
nonpublib load module. 


FPT Error 




All 


B5 


Secondary task uses a primary PUBLIB, or vice verso. 


FPT Error 




All 


66 


I/O error when trying to initiate a background program. 


FPT Error 




All 


B7 


Background program initiated into foreground or vice verso. 


FPT Error 





Table 0-3. TYC, BUSY and RIO, Byte Settings 



Service 
Type 


Service Started 
Normally 


Unable to Start Service 


Service Started and 
Completed Normally 


Service Started 
Normally, Com- 
pleted Abnormally 


Asynchronous 
Service 
with wait 


• 


Busy = 0; TYC = 00 if I/O, 
= Error Code if non-I/O; 
R10 from Table N-2, 

I/O: DCB Error or Abnormal 

non-I/O: R10 > 61 


TYC = 01; Busy = 0; 
R10 = Entry Value 


TYC from Table N-l; 
Busy 0; R10 from 
Table N-2, FPT Error 
or Abnormal 


Asynchronous 
Service 


TYC = 00; Busy = 1; 
RIO = Entry Value 


Busy = 0; TYC = 00 if I/O, 
= Error Code if non-I/O; RIO 
from Table N-2, 

I/O: DCB Error or Abnormal 

non-I/O: R10 > 61 






CHECK of a 

previous 

service 


TYC = 00; Busy = 1; 
RIO = Entry Value 
(Busy exit) 


(NOP) 


TYC = 01; Busy = 0; 
R10= Entry Value 


TYC from Table N-l; 
R10 from Table N-2, 
FPT Error or Abnormal 


Immediate 

Service 

Request 


" 


' 


TYC = 01; Busy = 0; 
R10= Entry Volue 


TYC from Table N-l; 
Busy = 0; R10 from 
Table N-2, FPT Error 
or Arirtormol 


DELFPT a 
Service 


TYC = 00; Busy = 1; 
R10= Entry Value 
(Busy exit) 


(NOP) 


TYC -01; Busy = 0; 
R10= Entry Value 
(successfully de- 
leted or normally 
completed) 


TYC from Table N-l; 
R10 from Table N-2, 
FPT Error or Abnormal 
(service deleted ab- 
normally or completed 
with errors) 
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APPENDIX P. VOLUME MITIAUZATION 



KTRODUCTION 

There it a special stand-alone processor called VOLINIT 
that initializes disk packs. Any number of disk packs can 
be initialized in a single run. VOLINIT establishes serial 
numbers and ownerships, writes headers and other system 
information In selected areas of the volumes, and tests 
the surface of the disks and selects alternate tracks to 
be used in place of flawed tracks, If necessary. The 
following information is a summary of VOLINIT operations 
procedures. For more detailed information refer to Pub- 
lication 706226- 11 D00. 



Note: If loading VOLINIT on a Sigma 9 with less than 
128K of memory, the following additional steps must 
be taken: 

• Place an address stop (stop on instruction) at location 
10C5 before performing Step 2, above. 

e When the program stops at location 10C5 (prior to 
Step 3), place the machine in instruction hold and 
step once. Then release the instruction hold and 
continue. 



LOADMG VOLINIT 

To get the Volume Initializer loaded into the system in 
preparation for reading control commands, use the following 
loading procedure: 

1. Form the following deck: 



VOLINIT COMMANDS 

Any number of disk pack devices can be initialized by one 
VOLINIT job. If a processor control command is lengthy 
and must be continued on another card, the continuation 
card must be concluded with a semicolon (;) character. 
The processor command has the form 



naK 



Initializer Control Command 
| Initializer Control Command 



r 



DPndd, mmmm[, (option), . . .(option)] 



where 




ndd specifies the address of the device containing 
the volume to be initialized. 



mmmm specifies the model number of the device. 



2. Set Sense Switch 1 and boot in from the card reader. 
Type NO or YES as desired in reply to a request to 
make any hardware assignment changes. 

3. When the deck is read in, key-in :SYST C, CRACK. 

4. Reset Sense Switch 1. The program will now be loaded 
and executed. 



The options are 



PUBLIC, sn specifies the serial number for the vol- 
ume being initialized is public or private. The 
serial number, sn, parameter is the one- to 
eight-byte EBCDIC serial number of the volume. 



FORMAT, ftj^r^' " "} f***** areos of the 
the device to be formatted. Formatting consists 
of the writing of sector headers and test patterns 
to verify the recording capability of a given area 
of a volume. If the FORMAT option is omitted, 
the entire device will be formatted by default. If 
the option (FORMAT, NONE) is specified, for- 
matting will not be performed. Otherwise, only 
those tracks specified in the range (s) adr j - adr2 
will be formatted. Each parameter 'adr' specifies 
a cylinder/track address, with a group of tracks 



328 Appendix P 



( 



specified by giving the addresses of the first 
and last tracks saparated by a hyphen. Thus, 
for example, the specification (FORMAT, 0/0, 
100/0-202/19) will cause the first track end 
the 100-202 cylinders of a disk pack volume 
to be formatted. 

An acceptable maintenance procedure is to format 
new disk packs and any volume being initialized 
that has not been formatted in the preceding two 
months. 



FLAW,odr j [-adr^ . . . specifies areas on the de- 
vice that will be unconditionally flawed (see 
"Flawing", below). The parameter odr| [-ad^] 
specifies a single cylinder/track address as in 
FORMAT. Those tracks that are found to be bod 
while formatting are automatically flawed; con- 
sequently, the FLAW option is necessary only for 
deleting tracks that are marginal or troublesome. 



The VOLINIT error summary should be maintained 
for each volume to keep a record of. bad tracks. 

NO TEST specifies that surface testing will be in- 
hibited. Areas specified by FORMAT are auto- 
matically surface tasted unless NO TEST is speci- 
fied. A surface test consists of writing preselected 
patterns on the device. 

If a processor command contains only the device name, 
DPndd and model number, with no options are specified, 
the VOLINIT processor logs the contents of the volume 
(serial number; date; public/private indicator; home ad- 
dress, if public; account number, if private; and the num- 
ber of available cylinders, if private) and does not write 
on the volume. If options have been specified, the pre- 
vious contents of the volume are invalid. 

It is important to note that the operator must make certain 
that the correct disk packs are mounted on the correct spin- 
dles before the VOLINIT commands are processed. 
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Note: For each entry in this index, the number of the most significant page is listed first, try pages thereafter are listed 
in numerical sequence. 



7244 pack copy, 270 

7251/52 disk area definition, 270 

7254 cartridge 

copies, 272 

Initialization, 270 

mounting, 271 

removal, 271 



A align specified columns, 209 
A assign command, 129 
abnormal 

address, 54 

codes, 322 

conditions, 54 
ABORT function call, 96 
access protection, 5, 110 
account inventory file, 4,228 
accounting log, 22 
ACTIVATE function call, 115 
ALARM call, 106 

alarm messages (SYSGENond SYSLOAD), 262-264 
ALARM receiver call, 106 
ALL map, 154 
ALL option, 261 
ALLOBT command (JCP), 19 
ALLOBT command (SYSGEN), 256 
allocating SParea, 262 
ALLOT command (RADEDIT), 170 
ALLOT function call, 60 
ANSCII control-character 

translation table, 236,237 

7-bit communication codes, 231 
AP examples, 184 
ARM function coll, 96,79 
assembly language, 152 
ASSIGN 

control command, 13,44, 149 

function call, 66 

service function, 44 
asynchronous operation control, 121 
asynchronous services, 315 
ATTEND command, 15 
ATTENTION key, 31 



B 



processing, 12 

program area, 3 

programs, 75 

temp area, 4, 1 1,44, 247 

temp area storage requirement, 270 

temp files, 19 
BATCH command, 19,226 
batch processing, 3 
BDSECTOR command, 178 
binary object modules, 145 
blank COMMON, 165 

control command, 146, 165 

name, 166 
BOOT26, 238 
BP command, 199 
BREAK, 224 

function, 198 

signal handling, 305 
buffer pool, 307 



B branch command, 131 
background, 1 

devices, 21 

job organization, 7 



C control segments command, 129 

C copy current line, 209 

CAL handling, 78 

CAL-parameter groups, 274-288 

CAL1 instruction, 44,54 

CALRTN function call, 99 

CANCEL command, 227 

card punch messagesAey-ins, 42 

card reader messages/key- ins, 42 

CATALOG command, 176 

CC control command, 17 

CHAN command, 252 

channel designation codes, 8 

character sets, 229 

check completion, 121 

check correspondence of DCB assignments, 66 

CHECK function call, 121,44,71 

checkpoint area, 4 

CL change string-search column limits, 207 

CLEAR command (patching), 296 

CLEAR command (RADEDIT), 173 

CLOSE function call, 55 

cluster designation codes, 8 

CM insert commentary, 205 « 

COC command (SYSGEN), 257 

COC support pockage, 297 

combined key-ins, 40 

COMMENT command, 259 

common allocation, 165 

COMMON control command, 146 

CONNECT function call, 96,79 

connecting primary tasks, 79 
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console interrupt, 290 
CONTINUE command, 228 
control codes, 229 
control commands, 12 
Control X, 223 
Control Y, 224 
cooperatives, 291 
COPY command, 171 
CORRES function call, 66 
CP-R 

control task, 5,31 

disk file management, 271 

function calls, 321 

functions, 3 

interrupting, 224 

lowest-cost, minimum configuration, 266 

memory management, 107 

messages, 26, 105 

processes, 1 

procedures system, 273 

responses, 26 

structure, 238 

system memory, 107, 106 

temp stack, 77 

terms, 1 
CTINT command, 258 



delete string, 207 

D dump command, 130 

DAL command, 22 

data control block (DCB), 2,44,49,151 

assignment, 50 

creation, 49 

format, 50 
DCBTAB, 151 
OCT, 44 

DE delete current record, 209 
DE delete records, 202 
DEACTIVATE function call, 116 
DEBUG, 126 

command, 227 

command syntax, 128 

commands, 128 

error messages, 132 

function call, 126 

functions, 127 

input, 127 

output, 127 

snapshot, 131 

trap control, 128 
DEFREFfile, 152 
DELETE command, 173 
DELETE function call, 62 
DELFPT function call, 122 
DEQ function call, 93 
device access, 45 



DEVICE command, 253 
device 

control, 41 

control messages, 31 

control table (DCT), 248 

designation codes, 8 

preemption, 48 
DEVICE/file mode function calls, 65 
direct access, 45 
direct I/O execution (lOEX), 48 
DISABLE function call, 99,79 
DISARM function call, 96,79 
DISCONNECT function call, 96,79 
disconnecting primary tasks, 79,314 
disk access methods, 45 
disk allocation, 246,247 
disk areas, 3, 246 

codes, 9 

default sizes, 247 

definition, 270 

protection, 170 
disk data protection, 43 

device model numbers and parameters, 255 

file account option, 44 

file identifiers, 10 

pack files, 45 

pack messages Aey- ins, 42 

restoration messages, 179,182 

volume initialization, 328 

write protection, 6 
DISPLAY format, 40 
D PC OPY command, 172 
DSECT allocation example, 147 
DT key-in, 31 
DUMP command, 176 



E 



E execution control command, 130 
E overwrite and extend blanks, 208 
EBCDIC 8-bit computer codes, 230 
EBCDIC file, 152 
echoing characters, 222 
EDIT, 197,7,220 

command, 199 

command structure, 198 

command summary, 213 

commands, 198 

input/output conventions, 197 

messages, 211 
ENABLE function call, 99,79 
END command (EDIT), 199 
END command (patching), 296 
END command (RADEDIT), 179 
end-action, 79 
end-action processing, 304 
ENQ function call, 92 
entering multiline records, 223 
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in 



entry address, 152 
EOD command, 20 
ERASE function call, 116 
erasing characters, 223 
erasing current input line, 223 
error 

address, 54 

codes, 322 

conditions, 54 

detecting, 224 

logging, 319 

reporting, 224 

response, 198 
ERRSEND function call, 105 
event management, 314 
EXCLUDE command, 146 
EXDA function call, 95 
executing background programs, 75 
EXIT command, 227 
EXIT function call, 95 
exit lower case interpret mode, 224 
extensible files, 46 
external definitions, 151 
EXTM command, 228 
EXTM function call, 87 



F 

F follow string, 208 

FAST option, 261 

FD find and delete records, 204 

file (also see disks) 

blocked, 45 

closing, 55 

commands, 199 

compressed, 45 

identifiers, 197 

opening, 54 

organization, 45 

permanent, 44 

temporary, 44 

unblocked, 45 
FIN command CEP), 20 
FIN command (SYSGEN), 259 
foreground, 1 

blocking buffers, 107 

job examples, 193 

|ob organization, 7 

mailbox, 107 

preferred memory, 5, 107 

private memory, 5, 107 

program, 17 

program area, 3 
FORTRAN interface, 165 
FORTRAN job examples, 187 
FS find and type sequence number, 204 
FT find and type record and sequence number, 204 
function parameter table (FPT), 2,44,273 



GDSECTOR command, 179 

GETASN function call, 67 

GETPAGE function call, 116 

GETTIME function call, 104 

GO command, 200,228 

GO file, 4,23 

GO, OV, X1-X9 default sizes, 248 



half duplex paper tape reading mode, 225 
hardware configuration guidelines, 266 
hardware interrupt requirements, 266 
hardware options, 272 



I 



I insert command, 129 

Vo 

cancelling, 223 

cleanup, 46 

device type codes, 8 

end action, 47 

Interrupt, 290 

Interrupt routines, 304 

key-in format, 41 

medium name, 11 

operation, 44 

queue table (IOQ), 248 

queueing, 46 

request, 44 

specifications, 8 

start, 46 

system, 44 

system calls, 54 

translation tables, 307 
immediate services, 314 
IN insert new records, 201 
In-line FPT form, 273 
INCLUDE control command, 145 
INIT command, 18,227 
INIT function call, 84 
Input 

control commands, 20 

conversion, 308 

interrupt processing, 304 

options, 294 

parameters, 249 

special action table, 307 

symbiont area, 4 

translation table, 308 
INT function call, 87 
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interpret upper cose as lower cote, 223 
interrupt 

control, 79 

inhibits, 290 

label table (1NTLB), 249 

switch, 31 
interrupr-strucrure summary, 268 
INTLB command, 258 
intrarecord editing commands, 205 
IOEX access area, 4 
IOEX calls, 69 

IOEX function status returns, 70 
IS insert new records, 202 



J 



JCP looder, 15,293 
JCP messages, 24 
JOB, 1,7,80,81 

accounting, 4 

command, 13,227 

concept, 313 

control processor, 12 

function call, 63 

management, 313 

resource management, 316 
JTRAP function call, 94 
JU jump, 210 



K-.BACKBG, 115 
K:BCKEND, 23,115 
K:BPEND, 23,115 
K:CCBUF, 23 
KrPAGE, 23 

keyboard-printer edited I/O, 49 
KJOB function call, 80 



LCOMMON command, 147 
L look command, 131 
L shift left, 208 
labeled COMMON, 166 
LIB control command, 145 
libraries, 152 

constructing, T53 

file sixes, 169 

maintaining, 153 

protection, 153 

public, 4, 150, 153 
LIMIT control command, 17 
line editor (see EDIT) 
line printer messages/lcey-ins, 43 
linking a program, 138 

memory management aspects, 1 10- 1 15 



linking CP-R system processors, 265 

LIST command, 16 

LMAP command, 175 

LMHDR command, 150 

LOAD command, 15 

load module, 1 

load module inventory (LMI), 248 

load-time assigns, 165 

loader-generated items, 151 

loading 

background programs, 75 

foreground secondary tasks, 74 

primary foreground programs, 75 

programs, 74 

system processors, 262 

user programs, 262 

VOLINIT, 328 
LOCK function call, 118 
logical device, 10,49 



M modify command, 129 
magnetic tape 

files, 21 

messagesAeyins, 43 
main program name and entry, 166 
main storage (memory) requirements, 268 
MAP command, 174 
mapped secondary task, 113,119 
master directory, 248 
MASTER function call, 102 
master mode, 77 

MO move and delete records, 203 
MDEF command, 256 
MEDIA command, 226 

control specification, 136 

conventions, 137 

key-ins, 136,39 

messoges, 137 

processing, 134 

service call, 134 
memory 

allocation, 238 

layout after SYSGEN, 238 

layout after SYSLOAD, 246 

layout of a program, 167 

management system calls, 115 

organization, 108 

partition, 107 

protection, 5, 1 10 

requirements for CP-R, 268,269 
MESSAGE command, 15,226 
MK move ond keep records, 203 
MOD command, 257 
MODIFY control command, 148 
MODIFY function call, 100 
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MODIFY porch area, 295 

MODIRfile, 152 

MODULE file, 152 

MONITOR command, 250 

monitor error and abnormal codes, 323 

multiline records, 198 

MUST command, 228,220 



N continue if no, 206 
N name command, 130 
NO make no change, 210 
null device, 10 



O overwrite, 208 
OFF command, 226 
on-line 

sessions, 222 

user processors, 220 
OPEN system call, 54,55 
operating system, 1 
operational label table (OPLBS), 249 
operational labels, 11,49 
operator communications, 26 
operator key- in, 31,32 
output 

conversion (EBCDIC - USASCII), 311 

interrupt processing, 304 

message formats, 31 

symbiont area, 4 
OV file, 4 
overlay 

example, 144 

inventory (OV1), 248 

load modules, 138 

loader, 6, 138 

loader control commands, 140 

loader diagnostics, 157 

loader examples, 191 

loading, 290 

restrictions, 139 

segment operations, 77 

segments, 151, 166 

structure, 7, 139 
overlays, 5 
OVLOAD table, 151 



P patch command, 130 
P precede strirg, 207 
pack initialization, 270 
paper tape input, 225 



patch 

command formats, 295 

CP-R monitor, 295 

quick, 294 

simulation routine, 295 

system overlay or JCP* 295 

system rabies, 295 
PAUSE command, 16 
PC function call, 87 
periodic scheduling, 318 
peripheral equipment requirements, 272 
peripheral equipment supported, 254,255 
PFIL command, 21 
PFIL function call, 59 
physical device names, 9 
PMD command, 20 
POLL function call, 90 
POST function call, 91 
power on/off, 272 
PREC command, 21 
PREC function call, 59 
PREFMODE function call, 119 
primary programs, 17,75 
primary task control block, 75 
primary task memory allocation, 109 
PRINT function call, 64 
PROC command, 250 
processor 

availability, 268 

control commands, 22 

interface with CP-R, 23 
program, 1 

control block (PCB), 2,76,151 

deck, 184 

file, 150 

map, 154, 155 
prompt characters, 222 
PUBLIB control command, 149 
PUNCH command, 259 



Q quit command, 131 

queueing primary foreground programs, 74 

QUIT command, 228 



R remove command, 131 

R shift right, 208 

RAD file table (RFT), 44,55,248 

RADEDIT, 6, 168 

calling, 170 

commands, 170 

error messages, 179 
READ function call, 55,56 
real memory allocation, 107 
real-time performance data, 290 



Index 



335 



Note: For each entry In this Index, the number of the most significant page is listed first. Any pat)** thereafter are listed in 
numerical sequence. 



real-time processing, 2 

RECALARM function call, 106 

record editing commands, 201 

reentrant subroutine, 2 

register blocks, 272 

registers 8 and 10 (error return), 54, 327 

releasing 

primary foreground programs, 75 

public library, 153 
RELPAGE function call, 117 
removable disk packs and cartridges, 270 
RES control command, 146 
RESERVE command (SYSGEN), 251 
reserved pages, 109 
reserving I/O devices, 48 
resource management, 316 
response to interrupts, 290 
RESTORE command, 178 
restricting input to upper case, 223 
RET command, 200 
return functions, 78 
retyping the current line, 223 
REWIND 

command, 21 

function call, 58 

manual command, 22 
RF reverse blank preservation mode, 211 
RFT (see RAD file table) 
RLS function call, 84 
RN renumber record, 204 
roll-in, 2,119 
roll-out, 2,119,120 
ROOT control command, 142 
root segments, 150 
ROV command, 17 
RUN command CJCP), 18 
RUN command (TEL), 227 
RUN function call, 83,315 
run-time assigns, 165 



S command, 131 
S substitute string, 207 
SAVE command (EDIT), 199 
SAVE command (RADEDIT), 178 
SCHED function call, 85 
scheduling programs, 74 
SE set intrarecord mode, 205 
secondary 

storage devices, 269, 255 

storage requirements, 269, 270 

storage utilization, 3 

task, 107,113,119 

task dispatch time, 290 

task memory, 5, 109 

task structures, 113 
SEG control command, 143 



SEGLOAD function call, 102,315 
segment 

access protection, 113 

activity, 111 

states, 111,112 
SEQ command, 199 
sequence numbers, 197 
sequential access, 45 
SET NAME command, 227 
SETNAME function call, 82 
setting the tab relative mode, 223 
SFIL command, 21 
sharing 

DCBs, 46 

disk files, 47 

I/O devices, 47 

segments, 112 
SIGNAL function call, 88 
simplified memory management (SMM), 115 
simulating 

tab characters, 223 

tab stops, 223 
SITE command, 259 
SJOB command, 18 
SJOB function call, 81 
skipping bad sectors, 168 
SLAVE function coll, 102 
slave mode, 77 
SMAP command, 174 
software checks, 320 
software segmentation, 110 
special code properties, 229 
SQUEEZE command, 173 
SS set and step, 205 
ST set, step, and type record, 205 
standard symbols and codes, 229 
START command, 228 
START function call, 99 
STARTIO function call, 72 
STATUS function call, 100 
STDLB command (J CP), 17 
STDLB command (SYSGEN), 258 
STDLB command (TEL), 226 
STDLB function call, 71 
STIMER function call, 104 
STOP command, 228 
STOP function call, 100 
STOPIO function call, 72 
subject file format, 197 
cymbiont fi le 

allot, 63 

delete, 63 
symbiont key-ins, 38 
symbionts, 5,291 

symbol-code correspondences, 232-235 
synchronous services, 314 
SYSGEN, 238 

SYSGEN control commands, 250 
SYSGEN map example, 239-245 
SYSGENLOAD, 238 
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SYSLD command, 259 
SYSLOAD, 238,260 
system 

alarm procedures, 320 

control commands, 13 

CP-R, 273 

CP-R errors, 274 

CP-R procedure references, 273 

DCBs, 50 

function call, 80 

generation, 238 

initialization, 294 

job inventory (SJI), 249 

library files, 169 

memory, 5 

messages, 31 

operational labels, 9 

patching, 294,296 

processors, 23 

program area, 3 

task inventory (STI), 249 

virtual memory, 109 



TABS command, 226 
task, 1 

control block (TCB), 2,75 

management, 314 

scheduling and operation, 74 

status format, 41 

virtual memory, 109 
TC type compressed, 202 
TEL commands, 226 
Teletype services (summary), 225 
Teletype terminal keyboard, 221 
temp stacks, 2, 151 
TERM function call, 95 
terminal executive language (TEL), 220,225 
terminal job entry (TJE), 220 

account maintenance, 228 

escape characters, 225 

key- ins, 37 

system, 2 
terminal operations, 220 
terminating foreground secondary tasks, 74 
terminating lines, 223 
TEST function call, 124 
TEXIT function call, 95 
TIME function call, 103 
trues command formats/ £VD 
TRAP function call, 94 
trap handler messages, 26 
trap handling, 78 
TRIGGER function call, 99 
triggering of interrupts, 79 
TRTN function call, 95 
TRTY function call, 95 
TRUNCATE command, 174 



TRUNCATE function call, 62 

TS type record, without sequence number, 203,210 

TV type record, with sequence number, 202,210 

type completion codes (TYC), 322-327 

TYPE function call, 64 

Type I request, 44,46,56 

Type II requests, 44, 56 

typing ahead, 223 

typing commands, 224 

typing error correction, 31 

typing lines, 222 

u 

unit designation codes, 8 
UNLOAD 

command, 22 

function call, 58 
UNLOCK function call, 118 
user 

areas, 3 

library files, 169 

temp stack, 77 
utility control commands, 21 



vertical format control (VFC), 52 
virtual memory allocation, 109 
VOLINIT commands, 328 
volume initialization, 328 



W command, 131 
WAIT function call, 103 
WAITALL function call, 123 
WAITANY function call, 124 
WEOF command, 22 
WEOF function, 58 
WRITE function call, 56 
write-key, 5 
write-lock, 5 



XDMP command, 177 

Xerox standard compressed language, 289 



Y continue if yes, 206 
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